home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / utils / eddy8c3.zip / EDDY.DOC < prev    next >
Text File  |  1996-05-11  |  432KB  |  8,963 lines
  1.  
  2.  
  3.  
  4.  
  5.                                 User's Manual for
  6.  
  7.  
  8.  
  9.              EEEEEEEEEEEE      DDDDD            DDDDD      YYY         YYY
  10.             EEEEEEEEEEEE      DDDDDDDD         DDDDDDDD     YYY       YYY
  11.            EEEEEEEEEEEE      DD      DD       DD      DD     YYY     YYY
  12.           EE                DD       DD      DD       DD      YYY   YYY
  13.          EEEEEEEE          DD        DD     DD        DD       YYYYYYY
  14.         EEEEEEEE          DD        DD     DD        DD         YYYYY
  15.        EE                DD        DD     DD        DD           YYY
  16.       EEEEEEEEEEEE      DD       DDD     DD       DDD           YYY
  17.      EEEEEEEEEEEE      DDDDDDDDDDD      DDDDDDDDDDD            YYY
  18.     EEEEEEEEEEEE      DDDDDDDDD        DDDDDDDDD             YYYYY
  19.  
  20.  
  21.  
  22.                                  EDit DirectorY
  23.                                     TWGDU! *
  24.  
  25.  
  26. |  NOTE:  A "|" in the first column of a line means there has been something
  27.    added or changed since the last release.
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                         +-------------------------------+
  34.                         |           EDDY (TM)           |
  35.                         |   File and Directory Editor   |
  36.                         |    Copyright (C) 1987-1996    |
  37.                         |       by  John Scofield       |
  38.                         |      All rights reserved      |
  39.                         |    CompuServe:  70162,2357    |
  40.                         +-------------------------------+
  41.  
  42.  
  43.  
  44.  
  45.                             _______
  46.                        ____|__     |               (R)
  47.                     --|       |    |-------------------
  48.                       |   ____|__  |  Association of
  49.                       |  |       |_|  Shareware
  50.                       |__|   o   |    Professionals
  51.                     -----|   |   |---------------------
  52.                          |___|___|    MEMBER
  53.  
  54.  
  55.  
  56.    * (The World's Greatest Disk Utility!)
  57.  
  58.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page   i
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  81.                                     DEDICATION
  82.  
  83.     EDDY is dedicated to the memory of Dean W. Anschultz, a good friend and a
  84.    GOOD man, in every sense of the word. His ideas, encouragement, and uncanny
  85.        abilities as beta-tester have been the major driving forces for the
  86.                  continuing development and improvement of EDDY.
  87.  
  88.                           Dean, you are missed.  R.I.P.
  89.    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  90.  
  91.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page  ii
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.                        DISCLAIMER - PLEASE READ CAREFULLY!
  108.    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  109.       BY USING THIS PROGRAM, EDDY ("THE SOFTWARE"), WRITTEN BY JOHN SCOFIELD
  110.       ("THE AUTHOR") YOU ACCEPT THESE TERMS:
  111.  
  112.         THE  SOFTWARE  AND  ITS  ASSOCIATED  DOCUMENTATION  ARE SUPPLIED
  113.         "AS-IS", WITHOUT ANY WARRANTY OF ANY KIND.  THE AUTHOR EXPRESSLY
  114.         AND SPECIFICALLY  DISCLAIMS ALL  REPRESENTATIONS AND  WARRANTIES
  115.         RELATING TO THE SOFTWARE, WHETHER EXPRESS OR IMPLIED, INCLUDING,
  116.         BUT  NOT  LIMITED TO, ANY IMPLIED  WARRANTIES  OF  QUALITY, PER-
  117.         FORMANCE, MERCHANTABILITY OR  FITNESS FOR  A PARTICULAR PURPOSE.
  118.         NEITHER  THE  AUTHOR  NOR  ANYONE  ELSE WHO HAS BEEN INVOLVED IN
  119.         THE DELIVERY OF THE SOFTWARE SHALL BE LIABLE FOR ANY DIRECT, IN-
  120.         DIRECT, SPECIAL, INCIDENTAL,  OR CONSEQUENTIAL  DAMAGES  ARISING
  121.         OUT OF THE USE OR  INABILITY TO USE THE SOFTWARE OR FOR ANY LOSS
  122.         OR  DAMAGE  OF ANY  NATURE  CAUSED TO ANY  PERSON OR PROPERTY AS
  123.         A RESULT  OF THE USE OF THE  SOFTWARE,  EVEN IF  THE AUTHOR  HAS
  124.         BEEN SPECIFICALLY  ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR
  125.         CLAIMS.  THE AUTHOR IS NOT RESPONSIBLE FOR ANY COSTS, INCLUDING,
  126.         BUT NOT LIMITED TO,  THOSE INCURRED  AS A RESULT OF LOST PROFITS
  127.         OR REVENUE, LOSS OF USE OF THE SOFTWARE, LOSS OF DATA, THE COSTS
  128.         OF  RECOVERING  ANY  SOFTWARE  OR  DATA,  OR THIRD-PARTY CLAIMS.
  129.         IN NO EVENT  SHALL THE AUTHOR'S LIABILITY FOR ANY DAMAGES TO YOU
  130.         OR ANY OTHER PARTY  EVER EXCEED  THE PRICE PAID FOR THE  LICENSE
  131.         TO USE  THE  SOFTWARE, REGARDLESS  OF  THE  FORM  OF THE  CLAIM.
  132.  
  133.    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  134.  
  135.                               USE AT YOUR OWN RISK!
  136.  
  137.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page iii
  138.  
  139.  
  140.                              TABLE OF CONTENTS
  141.  
  142.     1. Introduction to EDDY ............................................ 1-1
  143.        1.1 Hardware Requirements ....................................... 1-1
  144.        1.2 Installation ................................................ 1-2
  145.            1.2.1 INSTALLATION IS NOW COMPLETE! ......................... 1-2
  146.            1.2.2 Un-Installation ....................................... 1-2
  147.            1.2.3 Printing the Manual (this file) ....................... 1-2
  148.                a. Page Format .......................................... 1-2
  149. |              b. Paper Size Considerations ............................ 1-3
  150. |              c. Pretty Pictures ...................................... 1-3
  151.        1.3 Using EDDY With Windows ..................................... 1-3
  152.        1.4 EDDY's Display .............................................. 1-5
  153. |          1.4.1 Working and Target Directory .......................... 1-7
  154. |          1.4.2 Sequence & Sorting .................................... 1-7
  155. |          1.4.3 Number of Files ....................................... 1-8
  156. |          1.4.4 File Sizes, Available Space & Wasted Space ............ 1-9
  157. |          1.4.5 Directory Sizes ....................................... 1-9
  158. |          1.4.6 How About a Date? (non-USA date formats) .............. 1-10
  159. |      1.5 What You See Is What You Edit (WYSIWYE?) .................... 1-11
  160.  
  161. |   2. EDDY's DOS Command Line ......................................... 2-1
  162. |      2.1 [work] & [target] Directories ............................... 2-1
  163. |          2.1.1  Multiple, Simultaneous File Specifications ........... 2-1
  164. |          2.1.2  Single File Spec, No Wildcards ....................... 2-2
  165. |      2.2 Options ..................................................... 2-2
  166. |          2.2.1 Option Definitions .................................... 2-3
  167. |          2.2.2 Changing Options While Running EDDY - [Alt+o] ......... 2-5
  168. |      2.3 Other Command Line Parameters ............................... 2-5
  169. |      2.4 Response Files .............................................. 2-5
  170.  
  171. |   3. Telling EDDY What To Do ......................................... 3-1
  172. |      3.1 Moving Around ............................................... 3-1
  173. |          3.1.1 Using the Keyboard .................................... 3-1
  174. |          3.1.2 Using a Mouse ......................................... 3-1
  175. |              a. Changing the Button Command - [Alt+m] ................ 3-2
  176. |              b. If You're Left-handed ................................ 3-2
  177. |              c. Mouse Sensitivity - [Alt+Shift+m] .................... 3-3
  178. |          3.1.3 Using the Scroll Bar .................................. 3-3
  179. |          3.1.4 Double Click Shortcuts ................................ 3-4
  180. |      3.2 Commands .................................................... 3-4
  181. |          3.2.1 Hot Keys .............................................. 3-5
  182. |          3.2.2 Pull-Down Menus - [Alt+F1] ............................ 3-6
  183. |          3.2.3 Dialog Boxes .......................................... 3-7
  184. |          3.2.4 List Boxes ............................................ 3-8
  185.  
  186.     4. Editing Directory Entries ....................................... 4-1
  187.        4.1 Selecting a File or Directory (Speed Search) ................ 4-1
  188.        4.2 Renaming Files .............................................. 4-2
  189.        4.3 Changing Timestamps ......................................... 4-2
  190.        4.4 Changing File Attributes .................................... 4-3
  191.            4.4.1 Attributes Style #1 ................................... 4-3
  192.            4.4.2 Attributes Style #2 ................................... 4-3
  193.            4.4.3 "Network-shareable" Attribute ......................... 4-4
  194.  
  195.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page  iv
  196.  
  197.  
  198.  
  199.     5. Moving to a New Directory ....................................... 5-1
  200.        5.1 Dialog Boxes or Tree Diagrams - Your Choice ................. 5-1
  201.            5.1.1 How to Choose ......................................... 5-1
  202.            5.1.2 Performance Considerations ............................ 5-2
  203.                a. Memory is Always Up-to-Date .......................... 5-2
  204.                b. Save a Tree - [F5] ................................... 5-2
  205.        5.2 Directory Selection via Dialog Box .......................... 5-3
  206.            5.2.1 Working Directory Dialog Box - [Alt+Shift+w]/[Alt+w] .. 5-3
  207.            5.2.2 Target Directory Dialog Box - [Alt+Shift+t]/[Alt+t] ... 5-4
  208.            5.2.3 Target Tracking - [=] ................................. 5-5
  209. |          5.2.4 Cancel Target ......................................... 5-6
  210.        5.3 Directory Selection from Tree Diagram ....................... 5-6
  211.            5.3.1 Tree Display Format ................................... 5-6
  212.            5.3.2 Moving the Tree Highlight (Speed Search) .............. 5-6
  213.            5.3.3 Moving to a New Drive - [^letter] / [\] ............... 5-7
  214.            5.3.4 Working Directory Tree - [Alt+w] ...................... 5-8
  215.            5.3.5 Target Directory Tree - [Alt+t] ....................... 5-8
  216.        5.4 Directory Selection from Drive List - [\] ................... 5-9
  217.        5.5 Exchange Working & Target Directories - [Alt+x] ............. 5-9
  218.        5.6 Directory Recall - [Shift+F10], [Shift+^F10] ................ 5-9
  219.        5.7 Where's That File? - Option /W and [^w] ..................... 5-9
  220. |          5.7.1 Found It!  Make a List File - [Alt+l] / [^l] .......... 5-10
  221.        5.8 Working With "SUBST"ed Directories .......................... 5-11
  222.            5.8.1 From the Command Line ................................. 5-11
  223.            5.8.2 Interactively ......................................... 5-11
  224.  
  225.     6. HELP When You Need It - [F1] .................................... 6-1
  226.        6.1 HELP for Warnings and Other Messages ........................ 6-1
  227.        6.2 Topic Search by Keyword ..................................... 6-1
  228.  
  229.     7. UNDO Command - [F2], [^F2] ...................................... 7-1
  230.        7.1 Partial UNDO ................................................ 7-1
  231.  
  232.     8. LOOK Command - [F3], [^F3] ...................................... 8-1
  233.        8.1 LOOK at Subdirectory ........................................ 8-1
  234.        8.2 LOOK at File Contents (in Working Directory) ................ 8-3
  235.            8.2.1 Commands in LOOK Mode ................................. 8-3
  236.                a. Hex/ASCII Format Control - [Tab] / [Shift+Tab] ....... 8-3
  237.                b. Printing a File - [Alt+p] / [^p] ..................... 8-3
  238.                c. EGA/VGA Screen Control - [e] ......................... 8-3
  239.            8.2.2 ASCII Format Display .................................. 8-4
  240.            8.2.3 ASCII Format Commands ................................. 8-5
  241.                a. TAB Expansion - [#] / [Alt+#] ..................... .. 8-5
  242.                b. Bit-stripping - [b] / [Alt+b] ........................ 8-5
  243.                c. Ruler Line Display - [r] / [u] / [d] ................. 8-6
  244.                d. Jump to New Line - [j] ............................... 8-6
  245.                e. Line Wrapping - [l] / [Alt+l] ........................ 8-6
  246.            8.2.4 Hex Format Display .................................... 8-7
  247.            8.2.5 Hex Format Commands ................................... 8-8
  248.                a. Printability - [p] ................................... 8-8
  249.                b. Bit-stripping - [b] / [Alt+b] ........................ 8-8
  250.                c. Jump to New File Offset - [j] ........................ 8-8
  251.                d. Word-oriented Display - [w], [W] ..................... 8-9
  252.  
  253.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page   v
  254.  
  255.  
  256.  
  257.            8.2.6 LOOK Mode With a Mouse ................................ 8-9
  258.        8.3 LOOK at File Contents (in Target Directory) - [Alt+F3] ...... 8-9
  259.        8.4 LOOK at RAM (or ROM, or ???) ................................ 8-10
  260.        8.5 LOOK at Entire Disk ......................................... 8-10
  261.        8.6 Mark Data ................................................... 8-11
  262.            8.6.1 Jump to Marked Area - [Alt+m] ......................... 8-12
  263.            8.6.2 COPY Marked Area - [F5] ............................... 8-12
  264.            8.6.3 COPY Unmarked Area - [Alt+F5] ......................... 8-12
  265.        8.7 Compare Directory Entries - [Shift+F3], [Shift+^F3] ......... 8-13
  266.        8.8 Compare Files - [Alt+Shift+F3] .............................. 8-13
  267.  
  268.     9. PATCH Command - [F4], [^F4] ..................................... 9-1
  269.        9.1 Changing a File's Length .................................... 9-2
  270.            9.1.1 Appending Bytes to a File - [Alt+z] ................... 9-2
  271.            9.1.2 Deleting Bytes From a File - [Alt+y]/[Alt+a]/[Alt+b]... 9-2
  272.        9.2 Updating in PATCH - [Enter] or [^Enter] ..................... 9-2
  273.        9.3 PATCHing RAM ................................................ 9-3
  274.        9.4 PATCHing Disks by Sector .................................... 9-3
  275.  
  276.    10. Synchronization Controls - [Alt+c] .............................. 10-1
  277.        10.1 Controls for COPY/MOVE ..................................... 10-1
  278.        10.2 Tagging Confirmation Process ............................... 10-2
  279.        10.3 Synchronizing/Reconciling Directories ...................... 10-3
  280.        10.4 Controls for DELETE/DESTROY ................................ 10-3
  281.  
  282.    11. COPY Command - [F5], [^F5] ...................................... 11-1
  283.        11.1 COPY a File - [F5] ......................................... 11-2
  284.        11.2 COPY Multiple Files - [^F5] ................................ 11-2
  285.        11.3 COPYing Files With Disk Errors ............................. 11-2
  286.        11.4 COPY a Directory - [F5] .................................... 11-2
  287.        11.5 CONVERT File Data .......................................... 11-3
  288.            11.5.1 Expand TABs - [Alt+#] ................................ 11-3
  289.            11.5.2 Bit-stripping - [Alt+b] .............................. 11-3
  290. |      11.6 Make a Copy in Working Directory ........................... 11-4
  291.  
  292.    12. MOVE Command - [F6], [^F6] ...................................... 12-1
  293.        12.1 MOVE a File - [F6] ......................................... 12-1
  294.        12.2 MOVE Multiple Files - [^F6] ................................ 12-2
  295.        12.3 MOVE a Directory - [F6] .................................... 12-2
  296.        12.4 Fast Directory Move ........................................ 12-3
  297.            12.4.1 What Makes It Fast? .................................. 12-3
  298.            12.4.2 Had a Problem? Don't Panic! .......................... 12-3
  299.  
  300.    13. DELETE Command - [F7], [^F7] .................................... 13-1
  301.        13.1 Deleting Subdirectories .................................... 13-1
  302.        13.2 Logical DELETE (Ignore) - [Alt+F7], [Alt+^F7] .............. 13-2
  303.        13.3 DESTROY - [Shift+F7], [Shift+^F7] .......................... 13-2
  304.            13.3.1 Standard DESTROY Method .............................. 13-2
  305.            13.3.2 High-Security DESTROY ................................ 13-3
  306.            13.3.3 DESTROY a DRIVE! ..................................... 13-4
  307.  
  308.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page  vi
  309.  
  310.  
  311.  
  312. |  14. The EDDY.USE File ............................................... 14-1
  313. |      14.1 Point & Shoot Commands ("Associations") - [Shift+F9] ....... 14-1
  314. |          14.1.1 Modifiers ............................................ 14-3
  315. |          14.1.2 Replaceable Parameters ............................... 14-3
  316. |          14.1.3 Selecting an Association ............................. 14-5
  317. |          14.1.4 "*.*"-ish Selection .................................. 14-5
  318. |          14.1.5 Multi-File Operations - [Shift+^F9] .................. 14-6
  319. |      14.2 Default Command ............................................ 14-7
  320. |          14.2.1 Select Default Command - [Shift+F8] .................. 14-7
  321. |          14.2.2 Editing the Default Command .......................... 14-7
  322. |          14.2.3 Multi-file Operations - [Shift+^F8] .................. 14-8
  323. |      14.3 Printer Setup Commands ..................................... 14-8
  324. |          14.3.1 Printer Control - [Alt+9] ............................ 14-9
  325. |          14.3.2 Command Selection .................................... 14-9
  326.  
  327. |  15. DOS Gateway ..................................................... 15-1
  328. |      15.1 The DOS Shell - [F9] ....................................... 15-1
  329. |      15.2 Execute .COM, .EXE or .BAT File - [Alt+F9] ................. 15-1
  330. |      15.3 Using a Swap File .......................................... 15-2
  331. |      15.4 Environment Space .......................................... 15-2
  332.  
  333.    16. QUIT Command - [F10], [Esc] ..................................... 16-1
  334.        16.1 Directory Recall - [Shift+F10], [Shift+^F10] ............... 16-1
  335.        16.2 Exit to Directory - [Alt+F10] .............................. 16-1
  336.        16.3 EGA and VGA Display Control - [^F10] ....................... 16-1
  337. |      16.4 Final Screen ............................................... 16-2
  338.  
  339.    17. FIND and/or REPLACE String in File, Disk or RAM ................. 17-1
  340.        17.1 Entering New FIND Strings - [Alt+f] ........................ 17-2
  341.        17.2 Global Match Character - [Alt+g] ........................... 17-3
  342.        17.3 "Don't Match" Attribute - [Alt+k] .......................... 17-3
  343.        17.4 FIND "Any Text" ............................................ 17-4
  344.        17.5 FIND String in All Files - [^f] ............................ 17-5
  345.        17.6 FIND and REPLACE - [Alt+r] ................................. 17-5
  346.  
  347.    18. File Selection by Filtering ..................................... 18-1
  348.        18.1 Filtering by Attribute ..................................... 18-1
  349.            18.1.1 Attribute Selection from the Command Line ............ 18-1
  350. |          18.1.2 Attribute Selection in EDDY - [Alt+a]................. 18-2
  351.        18.2 Filtering by Timestamp...................................... 18-2
  352.            18.2.1 Timestamp Selection from the Command Line ............ 18-2
  353. |          18.2.2 Timestamp Selection in EDDY - [Alt+q] ................ 18-3
  354.        18.3 Exclusion - [*] ............................................ 18-4
  355.  
  356.    19. Playing With RAM ................................................ 19-1
  357.  
  358.    20. Volume Identifiers .............................................. 20-1
  359.        20.1 Volume Labels - [Alt+v] .................................... 20-1
  360.        20.2 Volume Serial Numbers - [^v] ............................... 20-1
  361.  
  362.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page vii
  363.  
  364.  
  365.  
  366. |  21. Printing ........................................................ 21-1
  367. |      21.1  Print a Copy of What's Displayed - [Alt+p] / [^p] ......... 21-1
  368. |      21.2  Printer Control ........................................... 21-1
  369. |          a.  Formfeed / Linefeed - [Alt+0] / [Alt+1] ................. 21-1
  370. |          b.  Printer Commands in EDDY.USE - [Alt+9] .................. 21-2
  371.  
  372. |  22. List Files - [Alt+l] / [^l]  (that's an "L", not a "ONE") ....... 22-1
  373. |      22.1  Single-directory List Files - [Alt+l] ..................... 22-1
  374. |      22.2  "Persistent" List Files - [^l] ............................ 22-2
  375.  
  376. |  23. Tracking Directory Changes with "Snapshots" ..................... 23-1
  377. |      23.1 Take Snapshot - [Shift+F5] ................................. 23-1
  378. |          23.1.1 Snap Working Directory Only .......................... 23-1
  379. |          23.1.2 Snap Working Directory Subtree ....................... 23-2
  380. |      23.2 Compare Directories with Snapshots - [Shift+F3] ............ 23-2
  381. |          23.2.1 Working Directory Snapshot Comparison ................ 23-3
  382. |          23.2.2 Subtree Snapshot Comparison .......................... 23-4
  383. |      23.3 Interrupting Snapshot Processing - [^c] .................... 23-4
  384.  
  385. |  24. Disk Jockey's Delight  (format-level disk functions) ............ 24-1
  386. |      24.1 "Compressed" or "Extended" Drives (CVFs: Stacker, etc.) .... 24-1
  387. |      24.2 LOOK at Entire Disk - [F3] ................................. 24-2
  388. |          24.2.1 Jumping Around ....................................... 24-3
  389. |              a. Jump to Sector - [j] ................................. 24-3
  390. |              b. Jump to Cluster - [Alt+j] ............................ 24-3
  391. |              c. Jump to Working Directory - [Alt+w] .................. 24-3
  392. |              d. Jump to Target Directory - [Alt+t] ................... 24-3
  393. |              e. Jump to Starting Cluster - [Alt+s] ................... 24-3
  394. |              f. Jump to Next Cluster - [Alt+n] ....................... 24-4
  395. |              g. Jump to Unallocated Cluster - [Alt+u] ................ 24-4
  396. |              h. Jump to "Bad Spot" - [Alt+b] ......................... 24-4
  397. |          24.2.2 Displaying Directory Entries - [Alt+d] ............... 24-5
  398. |          24.2.3 Who Owns That Cluster? - [Alt+o] ..................... 24-6
  399. |          24.2.4 COPY Unallocated Sectors ("Snoop") - [^u] ............ 24-7
  400. |      24.3 LOOK at Boot Sector - [^Home] .............................. 24-7
  401. |      24.4 LOOK at Partition Sector/Master Boot Record (MBR) - [@] .....24-8
  402. |      24.5 PATCH Anything on a Disk - [F4] ............................ 24-9
  403. |      24.6 That's Too Dangerous! ...................................... 24-9
  404. |      24.7 FIND Strings Anywhere on a Disk - [Alt+f] .................. 24-9
  405.  
  406. |  25. Working With Disk-Image Data .................................... 25-1
  407. |      25.1 COPY Disk Image - [Shift+F5] ............................... 25-1
  408. |          a. Upload/Download Entire Disks ............................. 25-1
  409. |          b. Make Multiple Copies Quickly ............................. 25-2
  410. |          c. Reduce Disks Needed for Backup ........................... 25-2
  411. |          d. No-Hassle Hard Disk Backup ............................... 25-2
  412. |      25.2 Disk-Image Restore - [Shift+F5] ............................ 25-2
  413. |      25.3 COPY Selected Disk Areas ................................... 25-3
  414. |          25.3.1 Mark Sectors (System Area) - [m] ..................... 25-3
  415. |          25.3.2 Mark Clusters (Data Area) - [m] ...................... 25-4
  416.  
  417.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page viii
  418.  
  419.  
  420.  
  421. |          25.3.3 Jump to Marked Area - [Alt+m] ........................ 25-4
  422. |      25.4 Data Recovery .............................................. 25-4
  423.  
  424. |  26. Directory Optimization .......................................... 26-1
  425. |      26.1 Sorting a Directory ........................................ 26-2
  426. |      26.2 Shuffling a Directory - [Alt+F6] ........................... 26-3
  427. |      26.3 Packing a Directory ........................................ 26-4
  428. |      26.4 Had a Problem? Don't Panic! ................................ 26-4
  429.  
  430. |  27. Wasted Space .................................................... 27-1
  431. |      27.1 Reclaiming Wasted Space .................................... 27-2
  432. |      27.2 Choosing a Partition Size - [F11] .......................... 27-2
  433. |      27.3 Partition Possibilities .................................... 27-3
  434. |      27.4 Compressed Volume File (CVF) Space Usage ................... 27-3
  435.  
  436. |  28. UPDATE Mode - [Enter], [^Enter] ................................. 28-1
  437. |      28.1 Applying Changes ........................................... 28-1
  438. |      28.2 Print a Record of Your Changes - [Alt+p] / [^p] ............ 28-2
  439. |      28.3 Target Capacity Check ...................................... 28-2
  440. |      28.4 Error Recovery ............................................. 28-4
  441. |          28.4.1 Data Errors .......................................... 28-4
  442. |          28.4.2 Cross-linked Files ................................... 28-5
  443.  
  444. |  29. Batch Operations ................................................ 29-1
  445. |      29.1 Commands Available ......................................... 29-1
  446. |      29.2 Processing Sequence ........................................ 29-1
  447. |      29.3 Synchronization Controls ................................... 29-1
  448. |      29.4 ERRORLEVEL ................................................. 29-2
  449.  
  450. |  30. EDDY's Default Settings are Lousy! .............................. 30-1
  451. |      30.1 Customizing - "EDDY/0" ..................................... 30-1
  452. |      30.2 Rainbow Selection - [Alt+r] ................................ 30-3
  453. |      30.3 Customizing a New Version of EDDY .......................... 30-4
  454. |          30.3.1 EDDY.INI ............................................. 30-4
  455. |          30.3.2 Configuration Parameters ............................. 30-5
  456. |              a. [administrivia] ...................................... 30-5
  457. |              b. [screen] ............................................. 30-6
  458. |              c. [mouse] .............................................. 30-7
  459. |              d. [printer] ............................................ 30-8
  460. |              e. [EDIT mode] .......................................... 30-8
  461. |              f. [LOOK mode] .......................................... 30-9
  462. |              g. [DOS Gateway] ........................................ 30-10
  463. |          30.3.3 Defining a Key - [Alt+k] ............................. 30-11
  464. |      30.4 How Do I Get Rid of the *$#^&! "UNREGISTERED" Message? ..... 30-11
  465. |      30.5 And How About the (expletive deleted) "REGISTER?" Button? .. 30-12
  466.  
  467. |  31. Registration is FOREVER! ........................................ 31-1
  468. |      31.1 Pricing .................................................... 31-1
  469. |          31.1.1 Payment .............................................. 31-1
  470. |          31.1.2 Updates .............................................. 31-2
  471. |      31.2 Registration by Credit Card ................................ 31-2
  472.  
  473.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page x
  474.  
  475.  
  476.  
  477. |      31.3 Registration by Mail ....................................... 31-2
  478. |      31.4 Registration via CompuServe - GO SWREG ..................... 31-3
  479. |      31.5 "The License" .............................................. 31-3
  480. |      31.6 Pass a Copy to a Friend ("de-personalized") ................ 31-3
  481. |      31.7 EDDY is NOT Free and NOT Public Domain! .................... 31-4
  482.  
  483. |  32. Distribution and Support / Disclaimer ........................... 32-1
  484. |      32.1 Technical Support .......................................... 32-2
  485. |      32.2 How Can I Get in Touch With You? ........................... 32-3
  486. |      32.3 Where Can I Find the Latest Version? ....................... 32-4
  487. |      32.4 A.S.P. Ombudsman ........................................... 32-5
  488.  
  489.  
  490.  
  491.  
  492.    Appendix A - Command Reference (Keys: Shiftless and Otherwise) ...... A-1
  493.        I.   Function Keys .............................................. A-1
  494.        II.  Letters .................................................... A-3
  495.        III. Numbers .................................................... A-5
  496.        IV.  Miscellaneous Keys ......................................... A-6
  497.  
  498.    Appendix B - What Does That Message Mean? ........................... B-1
  499.  
  500. |  Appendix C - Mouse Problems (Technical Note) ........................ C-1
  501. |      I.   Reset Method ............................................... C-1
  502. |      II.  Driver Versions ............................................ C-1
  503.  
  504. |  Registration Form .............................................. last page
  505.  
  506.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 1-1
  507.  
  508.  
  509.    1. Introduction to EDDY
  510.  
  511.    Modestly billed as "THE WORLD'S GREATEST DISK UTILITY", EDDY lets you do
  512.    just about ANYTHING you ever wanted to disks, directories and files, plus a
  513.    lot of things you probably never thought of!  Common stuff (find, copy,
  514.    rename, patch, view, zap, etc.) is generally easier than with other tools;
  515.    features you seldom need are LIFESAVERS when you do.  Reviewers say:
  516.    "clean, easy to use, well-written", "quality [like] we've seen from Peter
  517.    Norton", "the interface is elegant", "excellent documentation".
  518.  
  519.    EDDY is ALL of these...
  520.         Full-screen directory editor
  521.         Disk and directory manager
  522.         DOS shell
  523.         Sector editor
  524.         RAM editor
  525.         File finder (by name, attributes and/or timestamp)
  526.         File viewer/patcher/comparer
  527.         File backup utility
  528.         String finder/replacer (hex and/or ASCII)
  529.         Data recovery utility
  530.         Printer setup utility
  531.    ...and MUCH more!
  532.  
  533.    Most of what EDDY does isn't new; the program was developed as a test of
  534.    the "Build a better mousetrap..." theory of economics.  However, it often
  535.    provides a "new twist" on approaches to old problems.
  536.  
  537.    Some of the features and capabilities that have been reported by users as
  538.    particularly helpful (along with some of my own ideas about what's neat)
  539.    are described in the EDDY_WHY.DOC file.
  540.  
  541.    EDDY is also cheaper (but NOT free!  It is not in the public domain.) EDDY
  542.    is "shareware", sometimes known as "user-supported" software.  Distribution
  543.    and use of EDDY are subject to the conditions described in Section 32.
  544.  
  545.  
  546.    1.1 Hardware Requirements
  547.  
  548.    EDDY needs the following hardware and software:
  549.    -  IBM PC, one of its descendants, or close compatible
  550.    -  A monitor that can accommodate 25x80 text mode display
  551.    -  256K of available, conventional memory
  552.    -  PC- or MS-DOS level 2.0 or later
  553.  
  554.    If your monitor has more than 25 lines, EDDY can use them (up to a maximum
  555.    of 66 lines -- see Section 30.3.2b, the "max lines" parameter, for
  556.    information on customizing EDDY for this).
  557.  
  558. |  If your keyboard doesn't have function keys 11 and 12, EDDY can simulate
  559. |  them.  See Appendix A, Section I.
  560.  
  561.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 1-2
  562.  
  563.  
  564.  
  565.    1.2 Installation
  566.  
  567.    To install, copy (or decompress) the EDDY files into any directory.
  568.  
  569.    1.2.1 INSTALLATION IS NOW COMPLETE!
  570.  
  571.    That's all there is to it.
  572.  
  573.    Getting acquainted with the program is simple, too.  Just type "EDDY"
  574.    (without the quotes) and then [Enter].
  575.  
  576.    EDDY doesn't need to be in its own directory, nor even in the PATH.  It'll
  577.    find its files as long as at least the following are in the same directory:
  578.    EDDY.COM, EDDY.AUX, EDDY.USE, EDDY.INI.  If you are tight on disk space,
  579.    the only files that are ABSOLUTELY required are EDDY.COM and EDDY.AUX.
  580.  
  581.    There are extensive, context-sensitive HELP facilities -- press [F1] -- and
  582.    pull-down menus -- [Alt+F1].  HELP includes all of the basic information
  583.    needed to use EDDY.  There is no danger of damage to your disk data,
  584.    because no changes will be made to any of your directories or files until
  585.    you tell EDDY to do so.
  586.  
  587.    If EDDY's display is blurred, unreadable, or strange-looking, try "EDDY/M".
  588.    If it's OK, create a customized copy (see Section 30) with option /M on.
  589.  
  590.  
  591.    1.2.2 Un-Installation
  592.  
  593.    If you decide not to continue using EDDY, and want to get rid of it from
  594.    your disk, just type "DEL EDDY*.*" and [Enter].  If you DO do this, please
  595.    let me know what it is you don't like.  In a number of cases, I have been
  596.    able to modify EDDY to eliminate the cause of dissatisfaction.
  597.  
  598.  
  599.    1.2.3 Printing the Manual (this file)
  600.  
  601.    Many users like to print a copy of the manual.  It's all plain ASCII text
  602. |  (but see Section 1.2.3c) with formfeeds to keep the paging straight, so
  603.    most any print utility will do the job.  DOS's PRINT command is fine.
  604.  
  605.    a. Page Format
  606.  
  607.    The manual pages are formatted to fit on 8-1/2 x 11 paper, using 10
  608.    characters per inch ("Pica") type pitch -- the default for most printers.
  609.  
  610.    Page length is 59 lines or less, and MOST lines are a maximum of 78
  611.    characters wide.  There is a 3 character left margin for punching holes,
  612.    and a 2 character right margin.
  613.  
  614.    There are a few pages that contain screen samples, which require 80
  615.    characters per line.  An example is Figure 1-1, in Section 1.4.
  616.  
  617.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 1-3
  618.  
  619.  
  620.  
  621. |  b. Paper Size Considerations
  622.  
  623.    For European users' convenience, the page layout also accommodates printing
  624.    on A4 paper -- EXCEPT for the pages with screen samples.
  625.  
  626. |  To get the complete manual printed neatly (on 8-1/2 x 11 or A4 paper), I
  627.    suggest you set your printer to use 12 characters per inch ("Elite") type
  628.    pitch, and set the left margin to 6-8 to get the lines roughly centered on
  629.    the page.  This also handles "print screen" output neatly, so you might
  630.    consider making these printer settings your default.  (Nothing to do with
  631.    EDDY; just a suggestion).
  632.  
  633.    On many printers, these settings can be made from the control panel.  If
  634.    not, most printers accept command strings via software to accomplish the
  635.    same thing.  EDDY provides printer setup capabilities to do this, too.
  636.    For more info on this, look at the examples and explanations in the
  637. |  EDDY.USE file, and see Section 14.3.
  638.  
  639. |  c. Pretty Pictures
  640.  
  641. |  For those of you whose printers don't get upset when you feed them non-text
  642. |  characters, the file EDDY_FIG.DOC is included in the distribution package.
  643. |  This file contains one-for-one replacement pages for the EDDY.DOC pages
  644. |  that have Figures (screen-shot approximations) on them.
  645.  
  646. |  The pages from EDDY_FIG.DOC have much closer-to-real screen images,
  647. |  including "box" and "arrow" characters  -- a lot nicer to look at than the
  648. |  plain ASCII versions.
  649.  
  650.  
  651.    1.3 Using EDDY With Windows
  652.  
  653.    Two files are supplied to make using EDDY with MS Windows more familiar to
  654.    Windows users:  EDDY.PIF and EDDY.ICO.  These are the standard, Windows-
  655.    format Program Information File and an Icon file.
  656.  
  657.    The steps listed below __ARE NOT REQUIRED__ to run EDDY under Windows, but
  658.    may be used if you want the interface to EDDY from Windows to be smoother
  659.    than execution from a command line in a generic DOS box.
  660.  
  661.    For explanation purposes, assume that EDDY will be installed in a directory
  662.    called C:\UTIL\EDDY.  If you use a different directory, just substitute
  663.    yours in steps 1, 7 and 9.  To install EDDY in Windows...
  664.  
  665.    1.  Copy the files to C:\UTIL\EDDY (or whatever).
  666.    2.  Choose the group you want EDDY in (click on any icon in that group).
  667.    3.  In Program Manager, click on "File", then "New", then "Program Item".
  668.    4.  Click on "OK".
  669.  
  670.    - (process description continues on next page)
  671.  
  672.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 1-4
  673.  
  674.  
  675.  
  676.  
  677.    5.  Type the program description ("EDit DirectorY", or whatever you want).
  678.    6.  Click on "Command Line".
  679.    7.  Type C:\UTIL\EDDY\EDDY.COM (or whatever).
  680.    8.  Click on "Working Directory".
  681.    9.  Type C:\UTIL\EDDY (or whatever).
  682.    10. Click on "Change Icon".  If you see a "no icons" message, click "OK".
  683.    11. Click on "Browse", and select the drive and directory where you have
  684.        installed EDDY.
  685.    12. Double click on "EDDY.ICO", then click on "OK".
  686.    13. Click on "OK" again.
  687.  
  688.    WINDOWS INSTALLATION IS NOW COMPLETE!
  689.  
  690.    You may now run EDDY simply by double clicking on the EDDY icon.  When you
  691.    exit from EDDY, there will be a brief delay to allow you to view the
  692.    screen.  If you don't want to wait for that, press any key to return to
  693.    Windows immediately.  This delay does not occur with a registered copy.
  694.  
  695.    If you switch from running EDDY to some other Windows task, the EDDY icon
  696.    will be displayed, to remind you that EDDY is still running.  There is a
  697.    "hot key" defined in EDDY.PIF -- [Alt+^F9] -- that you may use to switch
  698.    quickly back to EDDY.  This may be changed by using the Windows PIF Editor.
  699.  
  700.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 1-5
  701.  
  702.  
  703.    1.4 EDDY's Display
  704.  
  705.    This is a sample of a typical EDDY display, which might have resulted from
  706. |  entering the command "EDDY C:"
  707.  
  708. ================================================================================
  709. filename.ext      size  mmddyy     time   RHSDAN
  710. DIR of C:\*.*                                                                  |
  711. Drive C: "John's Disk"       25 files,    450560 bytes,   104267776 bytes free |
  712.                                            58619 bytes wasted, cluster = 4096  |
  713. BAT          <DIR>     12-23-95  5:39:18p ...D..             |======|          |
  714. ETC          <DIR>     12-23-95  5:39:24p ...D..             | MENU |          |
  715. SYS          <DIR>     12-23-95  5:30:50p ...D..             |======|          >
  716. TEMP         <DIR>     12-25-95  5:35:12p ...D..             [Alt+F1]          |
  717. UTIL         <DIR>     12-23-95  5:39:30p ...D..                       |===|   |
  718. WINDOWS      <DIR>     12-23-95  5:39:36p ...D..             |======|  | R |   |
  719. AUTOEXEC BAT       137 11-19-95 10:55:20a ....A.             | HELP |  | E |   |
  720. CED      CFG       180 11-19-95  2:30:40p ....A.             |======|  | G |   |
  721. CED      COM      7562  7-24-91  2:50:02p ....A.               [F1]    | I |   |
  722. CMOSRSTR COM       821  3-31-93 10:00:00a ....A.                       | S |   |
  723. CMOSSAVE COM      1270  3-31-93 10:00:00a ....A.             |======|  | T |   |
  724. COLDBOOT COM         5  3-27-90  1:10:00a ....A.             | LOOK |  | E |   |
  725. COMMAND  COM     55777 11-17-94  1:00:00p ......             |======|  | R |   |
  726. CONFIG   SYS       535  1-07-96  7:39:58p ....A.             [Enter]   |===|   |
  727. DOUBLE   EXE    192816 12-29-95  8:02:00a ....A.                      [Alt+z]  |
  728. EDDY     COM     62704 12-30-95 10:01:54p ....A.             |======|          |
  729. ENVEDT   EXE      5102 12-30-95 10:01:56p ....A.             | QUIT |          |
  730. RANDY    COM      6364 12-29-95  8:02:00a ....A.             |======|          |
  731. WOMBAT   EXE      9203  9-27-90 12:39:12a ....A.              [F10]            |
  732.                                                                   Target: none |
  733. -EDIT- seq=N  [F2]:UNDO  [F3]:LOOK  [F5]:COPY  [F6]:MOVE  [F7]:DELETE  [F9]:DOS
  734. ================================================================================
  735.  
  736. |                                  Figure 1-1
  737.  
  738. |  For "drives" that are recognized by EDDY -- either automatically or as
  739. |  identified by the user -- as being "compressed volume files" (CVFs), the
  740. |  third line of the first screen will show "[CVF]" instead of "Drive".
  741.  
  742. |  You may notice a brief delay after the first display appears, when EDDY
  743. |  doesn't respond to the keyboard.  This is because some initialization
  744. |  processing that EDDY has to do is deferred until that time.  However, the
  745. |  overall effect is that you get that initial display noticeably faster than
  746. |  would otherwise be the case.  A major part of the delay is associated with
  747. |  mouse initialization (see Section 30.3.2c).  The delay is shorter if you
  748. |  use a registered copy of EDDY.
  749.  
  750.    Figure 1-1 is the default display style (attributes style=1).  There is
  751.    another style for displaying attributes, shown below in Figure 1-2.  You
  752.    may toggle between these two styles by pressing [Tab].
  753.  
  754.    If you prefer the style in Figure 1-2 (attributes style=2), you may
  755.    customize EDDY accordingly, to make that style the default.  See Section
  756.    4.4 and 30.3.2e (the "attributes style" parameter) for more information.
  757.  
  758.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 1-6
  759.  
  760.  
  761.  
  762. ================================================================================
  763. filename.ext      size  mmddyy     time   RHSDAN
  764. DIR of C:\*.*                                                                  |
  765. Drive C: "John's Disk"       25 files,    450560 bytes,   104267776 bytes free |
  766.                                            58619 bytes wasted, cluster = 4096  |
  767. BAT          <DIR>     12-23-95  5:39:18p nnnynn             |======|          |
  768. ETC          <DIR>     12-23-95  5:39:24p nnnynn             | MENU |          |
  769. SYS          <DIR>     12-23-95  5:30:50p nnnynn             |======|          >
  770. TEMP         <DIR>     12-25-95  5:35:12p nnnynn             [Alt+F1]          |
  771. UTIL         <DIR>     12-23-95  5:39:30p nnnynn                       |===|   |
  772. WINDOWS      <DIR>     12-23-95  5:39:36p nnnynn             |======|  | R |   |
  773. AUTOEXEC BAT       137 11-19-95 10:55:20a nnnnyn             | HELP |  | E |   |
  774. CED      CFG       180 11-19-95  2:30:40p nnnnyn             |======|  | G |   |
  775. CED      COM      7562  7-24-91  2:50:02p nnnnyn               [F1]    | I |   |
  776. CMOSRSTR COM       821  3-31-93 10:00:00a nnnnyn                       | S |   |
  777. CMOSSAVE COM      1270  3-31-93 10:00:00a nnnnyn             |======|  | T |   |
  778. COLDBOOT COM         5  3-27-90  1:10:00a nnnnyn             | LOOK |  | E |   |
  779. COMMAND  COM     55777 11-17-94  1:00:00p nnnnnn             |======|  | R |   |
  780. CONFIG   SYS       535  1-07-96  7:39:58p nnnnyn             [Enter]   |===|   |
  781. DOUBLE   EXE    192816 12-29-95  8:02:00a nnnnyn                      [Alt+z]  |
  782. EDDY     COM     62704 12-30-95 10:01:54p nnnnyn             |======|          |
  783. ENVEDT   EXE      5102 12-30-95 10:01:56p nnnnyn             | QUIT |          |
  784. RANDY    COM      6364 12-29-95  8:02:00a nnnnyn             |======|          |
  785. WOMBAT   EXE      9203  9-27-90 12:39:12a nnnnyn              [F10]            |
  786.                                                                   Target: none |
  787. -EDIT- seq=N  [F2]:UNDO  [F3]:LOOK  [F5]:COPY  [F6]:MOVE  [F7]:DELETE  [F9]:DOS
  788. ================================================================================
  789.  
  790. |                                  Figure 1-2
  791.  
  792.    The rectangles on the right side of the screen are used as "click" buttons
  793.    with a mouse; clicking on them results in the indicated action.  They are
  794.    actually displayed as neat boxes with double outlines, but those characters
  795.    don't show up well on many printers.  Although primarily intended for use
  796.    with a mouse, they may also be used with the keyboard.
  797.  
  798.    If you "click" in the blank area near the rectangles, the last command (if
  799.    any) that was executed by using the menu will be repeated.  This is useful
  800.    for tagging several files for the same action, such as COPY or DELETE, e.g.
  801.  
  802. |  When you have used the "Update" function 3 times, the "REGISTER?" button
  803.    will be highlighted and "[Alt+z]" will blink, as a reminder that registra-
  804.    tion might be appropriate.  The "REGISTER?" button does not appear if you
  805.    are using a registered copy of the program.
  806.  
  807.    At the right edge is a scroll bar, shown here only as an approximation of
  808.    the actual display.  The scroll bar is also intended mainly for mouse use
  809.    (see Section 3.1.3), but may be used with the keyboard, too.
  810.  
  811.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 1-7
  812.  
  813.  
  814.  
  815. |  1.4.1 Working and Target Directory
  816.  
  817.    The directory displayed by EDDY is referred to as the "working directory".
  818.    If any files are copied or moved, they are put in the "target directory".
  819.  
  820.    The working directory path you use may have a file specification (wildcards
  821.    allowed) appended to it. If it does, only files that match that file
  822.    specification are included in the display; if not, "*.*" is used.  You may
  823.    also press [*], to tell EDDY to EXCLUDE any files that match, and include
  824.    only those that DON'T match the file specification.  See Section 18.3.
  825.  
  826.    The working and target directories may be given on the DOS command line
  827.    when you execute EDDY.  They may be changed at any time (see Section 5).
  828.    If the command line doesn't specify any directory, the DOS default
  829.    directory on the default drive will be the initial working directory.
  830.  
  831. |  If you start EDDY with a working directory on a disk that EDDY can't tell
  832. |  positively whether it is a "compressed drive" (CVF) or not, you'll be
  833. |  asked.  Perhaps annoying, but it won't happen any more if you customize.
  834.  
  835.    The target directory currently in use, if any, is shown in the lower right
  836.    hand corner of the display, on the next-to-last line.  If "target tracking"
  837.    is in effect (see Section 5.2.3), the display will show "Target=" instead
  838.    of the normal "Target:".
  839.  
  840.    If a directory path is very long, it may not fit in the available screen
  841.    space.  EDDY will "abbreviate" the path to fit the space.  An abbreviated
  842.    path includes "\*#*\" in place of one or more subdirectories that have been
  843.    omitted from the displayed string in order to make it fit.  The "#" is
  844.    actually a digit, showing how many subdirectories have been omitted.
  845.  
  846.  
  847. |  1.4.2 Sequence & Sorting
  848.  
  849.    The information in this section concerns the sequence of the display on the
  850.    screen; you may also sort the directory permanently, on the disk.  Refer to
  851.    Section 26.1 for more details on this.
  852.  
  853.    EDDY's starting display is sorted by file name.  The sequence is indicated
  854.    on the last line of the display.  In Figure 1-1 the last line shows the
  855.    notation "seq=N", indicating sort by NAME.  Possible values of "seq" are:
  856.  
  857.      "D" - sorted by DATE, time, name & extension
  858.      "E" - sorted by EXTENSION & name
  859.      "H" - sorted by HOUR & minute
  860.      "N" - sorted by NAME & extension
  861.      "S" - sorted by SIZE, name & extension
  862.      "U" - UNSORTED; i.e., in the sequence stored in the directory by DOS
  863.  
  864.    EDDY builds the first display in name sequence.  If you would prefer a
  865.  
  866.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 1-8
  867.  
  868.  
  869.    different initial sequence, refer to Section 2.2.1 for information on the
  870.    use of option /1 to change the sort sequence for the initial display.
  871.  
  872.    To change the sequence, press [Alt+d], [Alt+e], [Alt+h], [Alt+n], [Alt+s]
  873.    or [Alt+u].  The directory will be re-sorted in the sequence requested, and
  874.    the "seq" field on the bottom line will be updated.
  875.  
  876.    Subdirectories are an exception:  except for UNSORTED sequence, all
  877.    subdirectories are grouped at the top of the display, before any file
  878.    entries.  This is to make it easier to move around the disk, from
  879.    subdirectory to subdirectory, using the LOOK command (see Section 8.1).
  880.  
  881.    To invert the order of the display (e.g., to get the files with the most
  882.    recent dates at the top), press [Alt+i].  When the display is inverted, an
  883.    up-and-down arrow appears just to the right of the "seq" field.
  884.  
  885.    Once the display has been inverted, it remains that way until [Alt+i] is
  886.    pressed again; [Alt+i] is a toggle.  Thus, if the display is by date,
  887.    inverted (i.e., newest date first) and you press [Alt+s], the resulting
  888.    display will be by size, inverted (biggest files first).
  889.  
  890.    Inverting is different from sorting.  Inverting just reverses the order of
  891.    the list of files currently displayed, and makes any later sort produce an
  892.    inverted list.  Inverting does not cause the directory to be reprocessed.
  893.  
  894.    Under some unusual circumstances, you may see the following warning message
  895.    when you enter a command to re-sort:
  896.                "Sorting cancels changes not UPDATEd. Sort (y/n)?"
  897.  
  898.    This occurs when you have very little memory available for EDDY's use, and
  899.    there are lots of pending changes when you enter the command.  EDDY will
  900.    always handle at least 160 pending changes without this problem.
  901.  
  902.  
  903. |  1.4.3 Number of Files
  904.  
  905.    With displays containing more than one page, an arrow, pointing up and/or
  906.    down appears in the upper right corner to show that there is more data to
  907.    be viewed by scrolling in that direction.
  908.  
  909.    EDDY can display up to 800 or so directory entries, depending on available
  910.    memory.  This is a limit on the display, not on the size of directories.
  911.    If you had, say, 1500 files in directory "\BIGDIR", and you wanted to work
  912.    with assembler source files, typing "EDDY \BIGDIR\*.ASM" would yield a
  913.    display of all .ASM files (up to around 800).
  914.  
  915.    If EDDY's display capacity is exceeded, the number of files indicated on
  916. |  the third line ("25 files" in Figure 1-1) will be replaced by two numbers.
  917.    First is the number of files displayed; second is the additional number of
  918.    files which would have been displayed if there had been enough room.  In
  919. |  Figure 1-1, if the directory had contained 930 entries, the "25 files"
  920.    would be replaced by "800+0130 files".
  921.  
  922.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 1-9
  923.  
  924.  
  925.  
  926.    When EDDY finds too many files to display at once, files are "dropped off"
  927.    the end of the list according to the current sequence.  For example, if the
  928.    sequence is by date, inverted, the files with the oldest dates would be
  929.    dropped.  Sorting again will reprocess the entire directory, dropping those
  930.    files which come at the end of the list according to the new sequence.
  931.    (Inverting will redisplay the current list in the opposite order.)
  932.  
  933.    It is possible to display up to double EDDY's capacity, by first displaying
  934.    the files in one sequence and then inverting and re-sorting.  Suppose a
  935.    directory had 1500 entries, and was displayed in "Name" sequence.  The first
  936.    800 files would be displayed.  To see the rest of the files in this
  937.    directory, press [Alt+i].  This would show the rest of the files, starting
  938.    from the opposite end, in inverted name sequence.
  939.  
  940.  
  941. |  1.4.4 File Sizes, Available Space & Wasted Space
  942.  
  943.    The display also shows the number of bytes used by the files in the
  944.    directory, the number of free bytes left on the disk, wasted space (for
  945.    more on this, see Section 27), and the cluster size used by the disk.
  946.  
  947.    Space occupied by subdirectories normally is not included in the display
  948.    (but see discussion in the next section).
  949.  
  950. |  If the directory has more files than EDDY can display, the "bytes" figure
  951. |  is the total for all files (i.e., the "800+0130 files" in the example from
  952. |  the preceding section).
  953. |
  954. |  The number of free bytes is the figure reported by DOS, with one exception:
  955. |  With compressed drives (CVFs), such as Stacker and the like, only an
  956. |  estimate of the free space is provided.  It is calculated by the
  957. |  compression tool, based on the expected compression ratio.
  958. |
  959. |  In most cases, the tool does the calculation, reporting the results
  960. |  transparently to using programs (such as EDDY) via the normal DOS
  961. |  mechanisms.  For DoubleSpace/DriveSpace CVFs, however, Microsoft has kindly
  962. |  provided a different function, which instead reports the actual number of
  963. |  uncompressed free sectors available.  This is translated by EDDY into an
  964. |  estimate of free bytes by using an expected compression ratio of 1.5.  This
  965. |  (or any other estimate, even if provided by the tool) may not be accurate,
  966. |  so that some operations (e.g., COPY) COULD fail for lack of space.
  967. |
  968. |  In addition, regarding DoubleSpace/DriveSpace CVFs, Microsoft tells us:
  969. |
  970. |      "The fragmentation of the compressed drive affects the interpretation
  971. |      of the free sector count.  Although this function returns the total
  972. |      number of free sectors, it does not specify the largest number of
  973. |      contiguous free sectors.  For some operations, there may be enough
  974. |      free sectors to complete the operation but not enough contiguous free
  975. |      sectors.  In this case, the operation will fail."
  976.  
  977.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 1-10
  978.  
  979.  
  980.  
  981. |  1.4.5 Directory Sizes
  982.  
  983.    Normally, for a subdirectory, you'll see "<DIR>" in the size field, and the
  984.    space occupied by the directories won't appear in the "bytes used" summary.
  985.    However, these directories do occupy space on the disk.  A single entry
  986.    (file or subdirectory) in a directory requires 32 bytes; thus, 128 entries
  987.    fit in a typical 4096-byte cluster.  If a directory has more entries than
  988.    can fit in a cluster, more clusters are allocated to the directory.
  989.  
  990.    If you'd like to see how much space is actually occupied by the subdirec-
  991.    tories on your disk, use option /D (see Section 2.2.1 for a discussion of
  992.    options).  But be prepared to wait longer for the display to be built; DOS
  993.    does not report directory sizes through its normal services.  EDDY must
  994.    interpret low-level format and FAT information directly, reading the
  995.    relevant sectors of the disk to get this information.  The sizes are shown
  996.    between "<" and ">" brackets (e.g., "<2048>", so directories are still
  997.    easily differentiated from files in the display.
  998.  
  999.    When displayed, directory sizes (except for the "." and ".." entries) are
  1000.    included in the "bytes used" summary.  The size of the "." entry is the
  1001.    size of the directory being displayed; it is not part of the space
  1002.  
  1003.    allocated to the files in that directory.  The ".." entry is also not
  1004.    included in the summary figure.  If the ".." entry is actually the root
  1005.    directory, you will see "<ROOT>" instead of a size, as the root size is
  1006.    fixed by the formatting process, and does not occupy space that would
  1007.    otherwise be available for file storage.
  1008.  
  1009.    If you delete entries, the directory space is NOT released; directories
  1010.    always stay as large as the most space that was ever required for them,
  1011.    even if there are NO files currently in the directory.  With standard DOS
  1012.    facilities, the only way to free up unused directory space is by deleting
  1013.    the directory itself.  EDDY offers another way, allowing you to free up
  1014.    space wasted in this way; see Section 26.3 for more information on this.
  1015.  
  1016.  
  1017. |  1.4.6 How About a Date? (non-USA date formats)
  1018.  
  1019.    If you use a date format other than the USA standard "mm-dd-yy", EDDY will
  1020.    use the format you choose.  The column heading above the date will indicate
  1021.    which format is being used, showing "mmddyy", "ddmmyy" or "yymmdd",
  1022.    accordingly.
  1023.  
  1024. |  There are two ways to specify the date format you wish to use.  Usually,
  1025. |  this is done by use of "COUNTRY.SYS" in your CONFIG.SYS file.  Or you may
  1026. |  customize EDDY to use the format you prefer.  (See Section 30.3.2e).
  1027.  
  1028. |  If you customize, the format you choose will always be used, even if it
  1029. |  conflicts with COUNTRY.SYS.  If neither customization nor COUNTRY.SYS is
  1030. |  used, the dates will be displayed as mm-dd-yy.
  1031.  
  1032.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 1-11
  1033.  
  1034.  
  1035.  
  1036.    1.5 What You See Is What You Edit (WYSIWYE?)
  1037.  
  1038. |  EDDY starts by displaying the entries in the working directory.  You may
  1039.    edit those entries, including filename, date, time and attributes.  Just
  1040.    move the cursor to the field you want to edit, and type your changes.
  1041.  
  1042.    You may also select files to be patched, copied, moved, deleted, etc.  (For
  1043.    more information on specific commands, see Section 3.2) All changes will be
  1044.    shown on the screen, but no changes will be made on disk until you tell
  1045.    EDDY to do so.  EDDY applies the requested changes to disk when you enter
  1046.    UPDATE mode, by pressing [Enter].  EDDY will ask you to confirm that you
  1047.    want to write to disk (by pressing [Enter] again), and will give you the
  1048.    choice of returning to EDIT without making any changes.
  1049.  
  1050.    At any time before writing changes to disk (in UPDATE mode), you may change
  1051.    your mind and UNDO the changes.  [F2] UNDOes changes to the current file,
  1052.    [^F2] UNDOes all changes to all files.
  1053.  
  1054.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 2-1
  1055.  
  1056.  
  1057.  
  1058.    2. EDDY's DOS Command Line
  1059.  
  1060.    The command line format is:
  1061.          EDDY [/option...] [work] [target] [+attribute...] ["timestamp"]
  1062.  
  1063.    The brackets -- "[" and "]" -- are not part of the format, and should not
  1064.    be typed on the command line.
  1065.  
  1066.    All parameters are optional.  The last two parameters, "attribute" and
  1067.    "timestamp", are for use in selecting files to be displayed by criteria
  1068.    other than paths and filenames with wildcards.  Full explanations of these
  1069.    are given in Section 18.
  1070.  
  1071.    When EDDY is executed without any options, paths or filenames given on the
  1072.    command line, the current DOS default drive and directory path are used.
  1073.  
  1074.    If you make an error in the command format, the format description line
  1075.    (above) will be displayed, with an arrow pointing to the part in error.
  1076.  
  1077.  
  1078.    2.1 [work] & [target] Directories
  1079.  
  1080.    On the command line, [work] defines the working directory, in normal DOS
  1081.    format, just as used with the DIR command (i.e., d:\path\filename.ext).
  1082.    Wild card characters are supported.  If no filename is given, *.* is
  1083.    assumed.  Paths may be specified using either "\" or "/", as you prefer.
  1084.    Similarly, ";" is treated as ":" (EDDY assumes that you forgot to [Shift]).
  1085.  
  1086.  
  1087. |  2.1.1  Multiple, Simultaneous File Specifications
  1088. |
  1089. |  You may provide up to FIVE different file specifications, either from the
  1090. |  command line or from the [Alt+w] dialog box.  File specs are separated by
  1091. |  commas.  Thus, to see all executable files in a directory, you could enter
  1092. |                          "EDDY  *.COM,*.EXE"
  1093. |  You can use (and mix) file specs with and without wildcards; e.g.,
  1094. |           "EDDY  *.COM,*.EXE,THISONE.ABC,THATONE.XYZ,*.B??"
  1095. |
  1096. |  Multiple file specs may also be used with "where-is" file searches (see
  1097. |  Section 5.7) and with the "file exclusion" feature (see Section 18.3).
  1098. |
  1099. |  If you run a program from a batch file, commas are not passed through by
  1100. |  DOS so that they are accessible to that program; all the program sees are
  1101. |  spaces where the commas were.  Therefore, if you want to use multiple file
  1102. |  specs when running EDDY from a batch file, an alternative is provided:
  1103. |  "+".  Any "+"s will be treated just the same as commas.  In the first
  1104. |  example above, the command line would be
  1105. |                          "EDDY  *.COM+*.EXE"
  1106. |
  1107. |  The two versions would be treated identically.  "+"s may not be used in the
  1108. |  [Alt+w] dialog box, however.
  1109.  
  1110.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 2-2
  1111.  
  1112.  
  1113.  
  1114. |  2.1.2  Single File Spec, No Wildcards
  1115.  
  1116.    If you enter a single, unambiguous filename -- i.e., no wildcards -- EDDY
  1117.    will go straight into LOOK mode for that file.  When you exit LOOK, the
  1118.    working directory will be "*.*".  (After going to LOOK in this way, you may
  1119.    notice that your disk's "busy" light comes on for a bit.  Not to worry!
  1120.    EDDY is using the time between keystrokes to build the "*.*" display, to be
  1121.    ready when you exit from LOOK.)
  1122.  
  1123.    For example, "EDDY c:\testdir\abc" would display all files in subdirectory
  1124.    "\abc" or, if there is no such subdirectory, display the contents of file
  1125.    "abc" in the "testdir" subdirectory.
  1126.  
  1127.    [target] defines the target directory, to receive any files copied or
  1128.    moved.  No filenames are allowed in the [target] specification.
  1129.  
  1130.    For example, "EDDY . C:" would display all files in the DOS default
  1131.    directory on the DOS default drive, and any files copied or moved would go
  1132.    to the DOS default directory on drive "C:".
  1133.  
  1134.  
  1135.    2.2 Options
  1136.  
  1137.    Options tell EDDY which of two possible actions you want used in various
  1138.    situations.  For example, you may choose option settings to determine:
  1139.    - whether a file's "archive" attribute should be changed when the file is
  1140.         copied;
  1141.    - whether to interpret characters typed in the filename field as changes to
  1142.         the filename or as a signal to search for a matching filename;
  1143.    - whether to use color in the display or not.
  1144.  
  1145. |  The meaning/effect of each option is detailed in the next Section.
  1146.  
  1147.    Options are given to EDDY on the DOS command line, as with normal DOS
  1148. |  commands, -- e.g., "EDDY /A/K" tells EDDY to use options "A" and "K".  (Or,
  1149. |  if you prefer, "EDDY -A-K" will have the same effect.)  Case is not
  1150. |  significant.  Options, if any, must be first, before any path or other
  1151. |  specifications, and must not be separated (e.g., by spaces).  They must
  1152. |  EACH be preceded by either a "/" or a "-"; i.e., "/AK" or "-AK" will not be
  1153. |  recognized.  Most options may also be set or changed during execution, by
  1154. |  pressing [Alt+o] (see Section 2.2.2).
  1155.  
  1156.    Options may be set either ON or OFF, with corresponding meanings described
  1157.    below.  Options (unless EDDY has been otherwise customized, as described in
  1158.    Section 30) are initially set to OFF, by default.
  1159.  
  1160.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 2-3
  1161.  
  1162.  
  1163.  
  1164.    2.2.1 Option Definitions
  1165.  
  1166.    /A - Do not change the file archive (modify) attribute when copying or
  1167.    moving files.  Default (option /A OFF) action depends on the drives used...
  1168.      - Floppy to floppy: copy's attributes set same as original
  1169.      - Hard disk to hard disk: copy's attributes set same as original
  1170.      - Floppy to hard disk: copy's archive attribute OFF, original unchanged
  1171.      - Hard disk to floppy: copy's archive attribute ON, original OFF
  1172.      - Remote (network) drives: attributes never changed
  1173.  
  1174.    /B - Turn off the "beep" that normally sounds for errors or warnings.
  1175.  
  1176.    /C - Do not change the cursor size.  Default is to use a larger cursor in
  1177.    EDIT mode, a full-height cursor in PATCH mode, and set it to a two-pixel
  1178.    high underline at exit.  If you start EDDY with this option OFF, and then
  1179.    turn it on, EDDY will not reset the cursor at exit.
  1180.  
  1181.    With /E and /C both ON, /C has no effect - i.e., the cursor will be changed
  1182.  
  1183.    /D - Include directory sizes in the display.  Disk space used by subdirec-
  1184.    tories is normally not included in the EDIT mode display.  With option /D
  1185.    ON, all such space will be accounted for.  However, gathering the infor-
  1186.    mation is VERY time-consuming, particularly on lower-speed hardware, so you
  1187.    may wish to use it only if it is really important to you.
  1188.  
  1189.    Option /D has no effect on remote (network) drives.
  1190.  
  1191.    /E - Set EGA or VGA monitor to use "extra-line" text display mode (43 or 50
  1192.    lines).  If the monitor is already in extra-line mode when EDDY starts, the
  1193.    option display window -- [Alt+o] -- will show /E is ON.  If you change /E
  1194.    while in EDDY, the display mode will change immediately.  If you were also
  1195.    using option /C, that option is turned OFF when /E changes
  1196.  
  1197.    /F - Turn on filename editing (i.e., renaming).  When /F is ON, files may
  1198.    be renamed by typing the new filename over the old.  If /F is OFF, typing
  1199.    in the filename field causes a "speed search" for a file with a matching
  1200.    name.  See Section 4.1 for more on this.
  1201.  
  1202.    With option /F turned OFF, pressing [Ins] in EDIT mode turns renaming ON
  1203.    for that file only, until the cursor moves to another line.  When option /F
  1204.    is ON (file renaming enabled), a "." appears between the filename and
  1205.    extension fields.  If it is ON for only the current file (i.e., you pressed
  1206.    [Ins]), then only that file's display has the ".".
  1207.  
  1208.    /H - Files with "hidden" or "system" attributes are not normally displayed
  1209.    unless they are explicitly requested by use of attribute filtering -- and
  1210.    with filtering, ONLY files with those attributes will be shown.  To include
  1211.    these files by default, together with all other files, use option /H.
  1212.  
  1213.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 2-4
  1214.  
  1215.  
  1216.  
  1217.    /K - Some error and status messages are displayed briefly (about 3 seconds)
  1218.    and then disappear.  If you would rather have the messages remain until you
  1219.    press a key (any key), use this option.  In this case, if the key you press
  1220.    is one of EDDY's command keys, the command will be executed.
  1221.  
  1222.    /L - List control.  Changes the scope of the [Ctrl]-shifted commands.
  1223.    Normally, these commands affect all files listed, starting from the top of
  1224.    the display (i.e., the first file).  If you want EDDY to start from the
  1225.    current cursor position (ignoring files higher up in the list), use /L.
  1226.  
  1227.    /M - Monochrome monitor.  Useful with mono monitor + Color Graphics
  1228.    Adapter, and with some laptops.  Other combinations do not need option /M,
  1229.    although it will toggle between color and mono on any color monitor.
  1230.  
  1231.    /R - RAM Editing.  With this option turned ON, EDDY treats the PC's memory
  1232.    as a file, which you may LOOK at, FIND strings in, PATCH or COPY.
  1233.  
  1234.    /W - Set "Where's That File?" searching; move to next directory that has a
  1235.    file which matches the current file spec and any timestamp and/or attribute
  1236.    filter used.  Search from working directory downward in the directory tree.
  1237. |  This option can be set by the user ONLY from the DOS command line, where
  1238. |  it tells EDDY to begin a "where's that file" search immediately.  It is set
  1239. |  internally by EDDY when the [^w] command is used.
  1240.  
  1241.    /0 - Execute in "customize" mode, to create a copy of EDDY with various
  1242.    features tailored to your preference (see Section 30).  This option can be
  1243.    set by the user ONLY from the DOS command line.
  1244.  
  1245.    /1x - Override the normal startup display sequence.  "x" must be one of the
  1246.    sort sequence codes defined in Section 1.4.2.  If "x" is a capital letter,
  1247.    the sequence will be in ascending order; if lowercase, in descending order.
  1248.    This option can be set by the user ONLY from the DOS command line.
  1249.  
  1250.    /2xxxxxx - Override the normal Synchronization Control settings, as
  1251.    described in Section 10.  From 1 to 6 "x"s may be used.  Each "x" must be
  1252.    "c", "y" or "n" except "c" is invalid for the sixth one.  Either case is
  1253.    O.K.  This option can be set by the user ONLY from the DOS command line.
  1254.  
  1255.    /5, /6, /7, /8 - These options correspond to keys [^F5], [^F6], [^F7] and
  1256.    [Shift+^F7] (COPY, MOVE, DELETE and DESTROY all files).  Only one of these
  1257.    options may be used at a time.  When these are used, the corresponding
  1258. |  command is carried out in batch mode (See Section 29).  This option can be
  1259.    set by the user ONLY from the DOS command line.
  1260.  
  1261.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 2-5
  1262.  
  1263.  
  1264.  
  1265.    2.2.2 Changing Options While Running EDDY - [Alt+o]
  1266.  
  1267. |  Change option settings by pressing [Alt+o].  A list box will appear (see
  1268. |  Section 3.2.4).  Pressing any of the option letters (except /W) toggles the
  1269.    option setting between ON and OFF.  Or move the cursor to an option and
  1270.    press [SpaceBar].  When the settings are the way you want them, press
  1271.    [Enter].  Pressing [*] resets the options to the values they had when EDDY
  1272.    started:  i.e., the default values, as modified by any options you used on
  1273.    the command line.
  1274.  
  1275.  
  1276.    2.3 Other Command Line Parameters
  1277.  
  1278.    Two other parameters may be entered on the command line:  an "attribute
  1279.    filter" specification and/or a "timestamp filter" specification.  These
  1280.    specifications are used to select files for display based on their file
  1281.    attributes -- hidden, directory, etc. -- or date and time.  They are
  1282.    explained in detail in Sections 18.1.1 and 18.2.1, respectively.
  1283.  
  1284.  
  1285. |  2.4 Response Files
  1286. |
  1287. |  If you often use similar, lengthy command lines -- e.g., lots of options,
  1288. |  long pathnames, multiple file specifications, and/or filters -- you may
  1289. |  want to consider using a "response file" rather than typing everything from
  1290. |  the command line every time.
  1291. |
  1292. |  A response file is identified to EDDY by preceding its filename with a "@".
  1293. |  Text from a response file is treated exactly as though it had been typed at
  1294. |  the command line.  The "@filename" may be preceded or followed by other
  1295. |  normal EDDY command line parameters.  For example, this command:
  1296. |                         "EDDY  /r @paths +A"
  1297. |  with the file "paths" containing the following text:
  1298. |                    "C:\UTIL\*.COM,*.EXE,*.DLL  D:\TEMP"
  1299. |  would run EDDY with option /R turned on, working directory "C:\UTIL",
  1300. |  target directory "D:\TEMP", only executable files displayed, and then only
  1301. |  if their Archive attribute is on.
  1302. |
  1303. |  Response files may be used alone, or in combination with parameters typed
  1304. |  directly from the command line, as illustrated by the preceding example.
  1305. |
  1306. |  The response file must be located in the current DOS directory, a directory
  1307. |  in the path, or in EDDY's "home" directory; i.e., where EDDY.COM is stored.
  1308. |  In our example, if there is a file or subdirectory in the current DOS
  1309. |  directory with the name "@paths", the name will be used as-is, rather than
  1310. |  as a response file.
  1311. |
  1312. |  You may use more than one response file in the same command line.  Nested
  1313. |  response files are not supported.
  1314.  
  1315.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 3-1
  1316.  
  1317.  
  1318.    3.  Telling EDDY What To Do
  1319.  
  1320.    EDDY's basic display provides full screen editing capabilities -- just move
  1321.    the cursor to the data you want to change, and type in the new data.
  1322.  
  1323.    The cursor may be moved with the keyboard or by mouse.  A "scroll bar" is
  1324.    also available.  [NumLock] state (ON/OFF) is always ignored by EDDY --
  1325.    i.e., treated as OFF -- unless [NumLock] is pressed while EDDY is running.
  1326.    Once it has been pressed, its state is recognized and treated accordingly.
  1327.  
  1328.    Other capabilities of EDDY are called upon by using commands.  Commands may
  1329.    be entered in whichever of the following ways you find most convenient:
  1330.  
  1331.          - Hot Keys
  1332.          - Pull-Down Menus
  1333.          - Command Line
  1334.  
  1335.    3.1 Moving Around
  1336.  
  1337.    Some fields on the screen, such as file size, can't be edited.  These
  1338.    fields are "protected" so that the cursor can't be moved to that position.
  1339.    Instead, it will move to the next unprotected position.
  1340.  
  1341.  
  1342.    3.1.1 Using the Keyboard
  1343.  
  1344.    In this document, key names are enclosed in brackets -- "[" and "]".
  1345.  
  1346.    The "arrow" characters are not printable in general, so the cursor control
  1347.    keys are indicated by the word -- left, right, up, down -- for the
  1348.    direction of the arrow that's printed on the key cap.
  1349.  
  1350.    In key names, the prefix "^" means the key is pressed at the same time as
  1351.    the [Ctrl] shift key.  The notations [Alt+key] or [Shift+key] mean that the
  1352.    [Alt] or [Shift] key is pressed at the same time as the indicated "key".
  1353.  
  1354.    EDDY's cursor is moved around in the display as follows:
  1355.  
  1356.      [Up]     - move up 1 line           [PgUp]   - up 1 page
  1357.      [Down]   - move down 1 line         [PgDn]   - down 1 page
  1358.      [Home]   - move to top of page      [End]    - move to end of page
  1359.      [^Home]  - display first page*      [^End]   - display last page*
  1360.      [Left]   - left 1 column            [Right]  - right 1 column
  1361.      [left bracket] - left 1 field       [right bracket]  - right 1 field
  1362.      [^Left]  - move to column 1         [^Right] - move to last column
  1363.  
  1364.      [/] - move to date field                [:] - move to time field
  1365.      [.] - left edge, except in a filename field [.] moves to extension
  1366.      [+] - move to attribute field (except in an attribute field, [+] turns
  1367.            the attribute ON and moves to the next file)
  1368.  
  1369.    ---------------------------------------------------------------------------
  1370.    * NOTE: Pressing [Home] twice in a row is the same as pressing [^Home], and
  1371.    pressing [End], [End] is the same as pressing [^End].
  1372.  
  1373.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 3-2
  1374.  
  1375.  
  1376.  
  1377.    3.1.2 Using a Mouse
  1378.  
  1379. |  If you're having problems with erratic mouse behavior, see Appendix C.
  1380.  
  1381.    EDDY reacts to mouse movement just as if you had used the arrow keys in a
  1382.    corresponding way (UNLESS you have moved all the way right, past the end of
  1383.    the highlighted area, to the scroll bar -- more on that in Section 3.1.3).
  1384.  
  1385.    Pressing the left mouse button ("left clicking") in EDIT mode is the same
  1386.    as pressing [F3].  With the cursor on a directory line, EDDY makes that the
  1387.    new working directory; a left click on a file line LOOKs at that file.
  1388.    This may be changed as described below.
  1389.  
  1390.    When EDDY is waiting for confirmation that you want to proceed with some
  1391.    action, a left click is the same as [Enter], meaning "Yes, proceed".  A
  1392.    right click is the same as [Esc], or "No, don't proceed".
  1393.  
  1394.    Click the left button while the cursor is on the "MENU" or "HELP" box at
  1395.    the right side of the screen to get the corresponding display.  Click the
  1396.    right button to return to the main body (left portion) of the display.  You
  1397.    may move the cursor around elsewhere in this area, but it has no effect.
  1398.  
  1399.  
  1400.    a. Changing the Button Command - [Alt+m]
  1401.  
  1402.    To change the command used for the left mouse button in EDIT mode (from
  1403.    the default of [F3]), press [Alt+m].  Next, press the key for the command
  1404.    that you prefer to use.  Also, see the next section.
  1405.  
  1406.  
  1407.    b. If You're Left-handed
  1408.  
  1409.    After [Alt+m], clicking the right mouse button instead of pressing a key
  1410.    swaps the use of the left and right mouse buttons, which is preferred by
  1411.    some left-handed people.  In that case, all descriptions of the right
  1412.    button actions actually apply to the left button, and vice versa.
  1413.  
  1414.    The scrollbar, described in Section 3.1.3, indicates the current state of
  1415.    "handedness" of the mouse, and can also be used to switch that state, as a
  1416.    shortcut instead of [Alt+m].
  1417.  
  1418.    If your mouse is already configured as "left-handed" within its own driver
  1419.    or by other software before running EDDY, you probably don't want to use
  1420.    this feature:  the result would be to swap the buttons back to "right-
  1421.    handed" usage.
  1422.  
  1423.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 3-3
  1424.  
  1425.  
  1426.  
  1427.    c. Mouse Sensitivity - [Alt+Shift+m]
  1428.  
  1429.    If your mouse reacts too quickly or too slowly when you move it, you can
  1430.    adjust the sensitivity (in Windows terminology, "Tracking Speed").  Press
  1431.    [Alt+Shift+m], and you'll get a graphical display showing the current speed
  1432.    relative to the maximum and minimum possible.  Move the mouse left to slow
  1433.    the mouse down or right to speed it up.  Left-click when the speed is the
  1434.    way you like it.
  1435.  
  1436.    If you customize EDDY, the sensitivity you select will be the default in
  1437.    the customized copy.
  1438.  
  1439.  
  1440.    3.1.3 Using the Scroll Bar
  1441.  
  1442.    At the far right edge of the screen you'll see a single, shaded column with
  1443. |  a solid square at either end; this is the "scroll bar".  Its main purpose
  1444.    is to give you an easy way of moving the display up or down with a mouse,
  1445.    although you may use it with the keyboard, too, if you wish.
  1446.  
  1447. |  The scroll bar also has a right- or left-pointing double arrow (the
  1448.    "slider").  The direction the triangle points indicates whether the mouse
  1449.    buttons are configured as right- or left-handed, respectively.  The
  1450.    position of the slider on the scroll bar gives you an approximate
  1451.    indication of how much further you must scroll to get to the end of the
  1452.    display.  For example, if EDDY has selected 90 files for display, and your
  1453.    current file is the 30th, the slider will be about 1/3 of the way down on
  1454.    the scroll bar.  If you're on the 90th file, the slider will be at the
  1455.    bottom.
  1456.  
  1457.    To use the scroll bar, move the cursor to a position either above or below
  1458.    the slider, and press the left mouse button (or [Enter]).  The display will
  1459.    scroll up if the cursor is above the slider, or down if below.
  1460.  
  1461.    The amount of scrolling depends on exactly where on the scrollbar the
  1462. |  cursor is located.  If on one of the solid squares at either end of the
  1463.    scroll bar, the display will scroll a line at a time in the indicated
  1464.    direction.
  1465.  
  1466.    If you left click directly on the slider, the mouse's "handedness" -- as
  1467.    described in Section 3.1.2b -- will change from left- to right-handed, and
  1468.    vice versa.
  1469.  
  1470.    Elsewhere on the scroll bar, each click moves the display a page at a time.
  1471.  
  1472.    Holding the left mouse button (or [Enter]) down causes the scrolling action
  1473.    to repeat.  If you are paging, this can cause the cursor to alternately be
  1474.    above and below the slider, which alternates between the same two pages.
  1475.  
  1476.    Click the right mouse button (or press [Esc]) to move quickly back to the
  1477.    main body of the display.  Or move the mouse or use the arrow keys for this
  1478.    if you prefer.
  1479.  
  1480.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 3-4
  1481.  
  1482.  
  1483.  
  1484.    3.1.4 Double Click Shortcuts
  1485.  
  1486.    Several common functions with the mouse are made easier if you use "double
  1487.    clicking" appropriately.  When the term "double click" is used without
  1488.    further qualification, it refers to two consecutive presses of the primary
  1489.    -- by default, the left -- mouse button.  Other types of double clicks are
  1490.    also recognized (two right button presses or a left and a right button),
  1491.    but they are explicitly described when used.
  1492.  
  1493.    The amount of time allowed between clicks for them to be recognized as a
  1494.    double click (in Windows terminology, "Double Click Speed") may be
  1495.    customized to be comfortable to you, as described in Section 30.3.2c.
  1496.  
  1497.    Here are some things you can do by using double clicking:
  1498.  
  1499.    - When EDDY asks for your choice between [Enter] or [^Enter] -- related to
  1500.      how timestamps are handled on file updates -- a left click is the same as
  1501.      [Enter], and a double left click is the same as [^Enter].  Examples of
  1502.      this are when you're ready to UPDATE either from EDIT or PATCH.
  1503.  
  1504.    - If you click both the left and right buttons within the double click
  1505.      interval, the result is the same as if you pressed [F1].
  1506.  
  1507.    - If you double click on an entry in the EDIT mode directory display, the
  1508.      cursor will move to the MENU button.
  1509.  
  1510.    - If you double click on the MENU button, the last command you have used by
  1511.      selecting from the menu will be repeated.  This is particularly useful
  1512.      for tagging several files for the same action, such as COPY or DELETE.
  1513.  
  1514.    - If you double click on the HELP button, HELP's keyword search screen will
  1515.      appear, just as if you had pressed [Shift+F1].
  1516.  
  1517. |  - If you double click on the LOOK button, you will go directly to PATCH the
  1518. |    current file, just as if you had pressed [F4].
  1519.  
  1520. |  - If you double click on the QUIT button, you will QUIT to the working
  1521. |    directory, just as if you had pressed [Alt+F10].
  1522.  
  1523.  
  1524.    3.2 Commands
  1525.  
  1526.    Commands tell EDDY what to do to the files that are displayed.  Generally,
  1527.    they affect the current file, as selected by the cursor.
  1528.  
  1529.    The most common commands are assigned to function keys.  Other commands
  1530.    generally are assigned to an [Alt+letter] combination.
  1531.  
  1532.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 3-5
  1533.  
  1534.  
  1535.  
  1536.    3.2.1 Hot Keys
  1537.  
  1538.    All of EDDY's functions may be called upon by using the corresponding "hot
  1539.    keys".  The following (VERY incomplete!) summary is provided simply to
  1540.    suggest how easy it is to use some of EDDY's most common commands.
  1541.  
  1542.    Further details of use of the various keys and key combinations may be
  1543.    found in the later sections of this document.  A complete list of command
  1544.    key assignments is given in Appendix A.
  1545.  
  1546.    Some common commands used in "EDIT" mode are:
  1547.  
  1548.    [F1]: HELP
  1549.    [F2]: UNDO changes on this file
  1550.    [F3]: LOOK at data in file, LOOK at files in directory, or LOOK at disk
  1551.    [F4]: PATCH data in file or on disk
  1552.    [F5]: COPY file
  1553.    [F6]: MOVE file
  1554.    [F7]: DELETE file
  1555.    [F9]: Exit to DOS temporarily (DOS shell)
  1556.    [F10]: QUIT, return to original DOS default directory
  1557.  
  1558.    [Alt+d]: Sort files by DATE/time           [Alt+n]: Sort files by NAME
  1559.    [Alt+e]: Sort files by EXTENSION           [Alt+s]: Sort files by SIZE
  1560.                         [Alt+i]: INVERT display sequence
  1561.  
  1562.    [Alt+f]: FIND string in file
  1563.    [Alt+o]: inquire/change OPTIONS
  1564.    [Alt+t]: inquire/change/create TARGET directory
  1565.    [Alt+w]: change WORKING directory/file selection
  1566.    [Alt+x]: eXCHANGE working & target directories
  1567.  
  1568.    Many command keys may also be used together with the [Ctrl] key.  [Ctrl]
  1569.    (indicated in this document by "^") means "do the command for all files".
  1570.    E.g., [^F5] means copy all files, and [^F2] means undo all changes on all
  1571.    files.  (Option /L -- see Section 2.2.1 -- changes the scope of the "^".)
  1572.  
  1573.    To interrupt one of the [^Fn] commands, press [^c] or [BackSpace].  Any
  1574.    files tagged for copy, delete, etc. up to that point will stay tagged, but
  1575.    no further action will take place.  If you just want to pause temporarily,
  1576.    to look at the screen or think about what's going on, press and hold
  1577.    [ScrollLock].  All processing will stop.  Release the key to continue.
  1578.  
  1579.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 3-6
  1580.  
  1581.  
  1582.  
  1583.    3.2.2 Pull-Down Menus - [Alt+F1]
  1584.  
  1585.    Press [Alt+F1] and a pull-down menu panel is displayed, as well as a menu
  1586.    bar across the top of the screen, with other menu topics to choose from.
  1587.  
  1588.    The menu panel lists commands which may be executed by EDDY.  To the right
  1589.    of each command a "hot key" is shown.  This key may be used to execute the
  1590.    command directly from EDDY, without using the menu.  To select a command
  1591.    from the menu, you may:
  1592.  
  1593.        1) press the highlighted letter for that command; or
  1594.        2) move the cursor to the command and press [Enter] (or left click
  1595.               your mouse); or
  1596.        3) press the indicated "hot key" for the command (unless the hot
  1597.               key is shown enclosed by "< >", in which case the hot key cannot
  1598.               be used from the menu).
  1599.  
  1600.    Some lines on some panels show "(sub-menu)" instead of a hot key.  If you
  1601.    choose one of these, another panel will be displayed, with commands
  1602.    relating to the subject you chose.  These commands may be selected in the
  1603.    same 3 ways described above.
  1604.  
  1605.    If you don't want to choose a command, press [Esc] (or right click mouse).
  1606.  
  1607.    To view the data in the display that has been covered by a menu panel,
  1608.    press [PgUp].  This allows you to look at the display (except the top line,
  1609.    which is covered by the menu bar) without exiting from the menu.  To pull
  1610.    down a menu panel, press the highlighted letter for the topic, or press
  1611.    [Enter] (or left click) to pull down the panel for the
  1612.    currently-highlighted topic.
  1613.  
  1614.    A list of other topics available is displayed across the top of the screen.
  1615.    The topics are those which pertain to the type of display you are working
  1616.    with.  For example, in EDIT mode, you won't see topics that relate to LOOK
  1617.    or PATCH modes.  To view the panels for the other topics shown at the top
  1618.    of the screen, press [Left] or [Right] (or move the mouse).
  1619.  
  1620.    In EDIT mode, the choice of topics also depends on the line your cursor is
  1621.    currently on.  If it's on a file, you'll get a choice of commands that are
  1622.    valid for files; if it's on a directory or disk line, you'll get choices
  1623.    that are valid for those lines.
  1624.  
  1625.    Similarly, in LOOK mode, some commands are valid only if the display is in
  1626.    ASCII (text) format, and some only with hex format.  Also, different
  1627.    commands are available when LOOKing at a file, disk or RAM.  The choices
  1628.    you'll see in the menus depend on what you're doing.
  1629.  
  1630.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 3-7
  1631.  
  1632.  
  1633.  
  1634.    The first time a particular menu bar is loaded at the top of the screen,
  1635.    EDDY makes a guess as to which panel from that menu bar you'll most likely
  1636.    want to use, and displays that panel.  On later calls which use that same
  1637.    menu bar, the menu panel displayed will be the last one you used.
  1638.  
  1639.    EDDY loads the MENU module from EDDY.AUX when you press [Alt+F1], if enough
  1640.    memory is available (around 24K).
  1641.  
  1642.    If you double click on the MENU button, the last command you have used by
  1643.    selecting from the menu will be repeated.  This is particularly useful for
  1644.    tagging several files for the same action, such as COPY or DELETE.
  1645.  
  1646.    The menus and HELP screens have their own color attributes, not tied to
  1647.    those used for other EDDY screens (but menu colors are the same as HELP
  1648.    colors).  These colors may be customized as desired (see Section 30.2).
  1649.  
  1650.  
  1651.    3.2.3 Dialog Boxes
  1652.  
  1653.    Some commands need more information in order to accomplish their functions.
  1654.    For example, [Alt+Shift+t] is used to select a new target directory; press-
  1655.    ing it displays a dialog box asking you to enter the required path.
  1656.  
  1657.    For these boxes, just type the required information, and press [Enter] when
  1658.    you are finished.  EDDY will use the new information according to the type
  1659.    of command involved.  If you make a mistake, or decide not to continue,
  1660.    press [Esc] and whatever you have typed will be discarded.
  1661.  
  1662.    Dialog boxes are used with these commands:
  1663.         [Alt+t]/[Alt+Shift+t]:  inquire/change/create TARGET directory
  1664.         [Alt+v]:  change/create VOLUME label
  1665.         [Alt+w]/[Alt+Shift+w]:  change WORKING directory/file selection
  1666.         [^w]:  "Where's That File?" search for WORKING directory
  1667.         [Shift+F9]:  point & shoot
  1668.  
  1669.    They may also appear as the result of some other commands, such as [F5] -
  1670.    COPY file -- when no target directory has been given.
  1671.  
  1672.    When a dialog box is displayed, the area into which to type data is
  1673.    highlighted in reverse video (or underline, with monochrome monitors).
  1674.    Text entry may be done in either "insert" mode, in which each keystroke
  1675.    entered pushes everything right one character, or "replace" mode, in which
  1676.    each keystroke overlays the character at the cursor.  You may toggle
  1677.    between insert and replace modes by pressing [Ins].  If you are in insert
  1678.    mode, a "right arrow" will appear directly below the cursor.  When the
  1679.    dialog box is first displayed, replace mode is in effect.
  1680.  
  1681.    If there is an initial string displayed, such as a path, you may edit it as
  1682.    desired, and press [Enter] when the result is ready for use.
  1683.  
  1684.    If the first key you press after the initial display is a character (i.e.,
  1685.    not a cursor control key) in the first (leftmost) position, the initial
  1686.    string will be erased, allowing a completely new string to be entered.  In
  1687.    addition, [^End] will always erase from the cursor to the end of line.
  1688.  
  1689.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 3-8
  1690.  
  1691.  
  1692.  
  1693.    If you want to redisplay the initial string after it has been erased, or
  1694.    after you have modified it, move the cursor to the leftmost position and
  1695.    press [Home].
  1696.  
  1697.    NOTE: The dialog boxes associated with the commands...
  1698.  
  1699.         [Alt+f]: FIND string in file
  1700.         [Alt+r]: FIND and REPLACE string in file
  1701.  
  1702.    do not follow these rules.  Refer to Section 17 for more information.
  1703.  
  1704.  
  1705.    3.2.4 List Boxes
  1706.  
  1707.    These boxes present a list of items for which state values may be selected
  1708.    (e.g., "ON/OFF", "YES/NO/MAYBE").  List boxes are used with these commands:
  1709.  
  1710.         [Alt+a]: file attribute filter selection
  1711.         [Alt+c]: inquire/change controls for Copy & Move
  1712.         [Alt+o]: inquire/change options
  1713.  
  1714.    To set values for an item in the list, move the highlighted cursor bar to
  1715.    the item and click the left mouse button or press [SpaceBar].  When all
  1716.    values are set correctly, move the cursor to the "OK/Cancel" line, ensure
  1717.    the "OK" box is highlighted, and left click or press [Enter].  The
  1718.    highlight is moved between "OK" and "Cancel" by pressing [Left] or [Right].
  1719.  
  1720.    If you click on this line or [Enter] while "Cancel" is highlighted, all
  1721.    changes will be discarded.  Changes may be discarded at any time by right
  1722.    clicking or pressing [Esc] -- from any line.
  1723.  
  1724.    To restore settings to the values they had when EDDY started executing --
  1725.    the default values, possibly modified by settings made from the command
  1726.    line -- press [*] or left click on the "*" line.
  1727.  
  1728.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 4-1
  1729.  
  1730.  
  1731.  
  1732.    4.  Editing Directory Entries
  1733.  
  1734.    To select a file for editing, move the cursor to the line of the display
  1735.    for that file.  The line with the cursor will be highlighted, and the
  1736.    corresponding file becomes the "current file".  Editing is then done by
  1737.    simply typing the new information over the old on the screen.
  1738.  
  1739.    The cursor will skip over fields which can't be edited, such as file size.
  1740.    If you try to enter data which is not valid (e.g., letters in a date or
  1741.    time field), EDDY will "beep" at you and ignore the entry.
  1742.  
  1743.    It is possible to enter combinations of characters which result in invalid
  1744.    data in a field.  For example, "02" is a valid month and "31" is a valid
  1745.    day, but together they are an invalid date.  EDDY catches errors of this
  1746.    type whenever you try to move the cursor off of the current file.  EDDY
  1747.    "beeps" and puts the cursor on the field where the error was detected.
  1748.  
  1749.    When any editing has been done, an "*" will appear at the right end of the
  1750.    line to indicate that changes have been made to that file.
  1751.  
  1752.  
  1753.    4.1 Selecting a File or Directory (Speed Search)
  1754.  
  1755.    There are two ways to move the cursor to the file (or directory) entry you
  1756.    are interested in:  by using the cursor keys ([Up], [Down], etc.), or
  1757.    directly, by using the "speed search" feature (with option /F turned OFF).
  1758.  
  1759.    With the cursor on the filename, typing any character that's valid for a
  1760.    filename tells EDDY to move the cursor to the next entry in the display
  1761.    with a name that matches.  Matching is done from the first character of the
  1762.    current filename up to and including the character just typed.
  1763.  
  1764.    For example, consider the display shown in Figure 1-1 (Section 1.4).  If
  1765. |  you were positioned on "WOMBAT.EXE", with the cursor on the "W", and you
  1766. |  pressed [e], the cursor would move to the "ETC" directory entry, with the
  1767. |  cursor on the "T".  If you then pressed [n], the cursor would move to the
  1768. |  "ENVEDT.EXE" filename, on the "V".
  1769.  
  1770.    If you press [Shift] and type a letter, that letter will always be matched
  1771.    against the FIRST letter of the file or directory name, regardless of which
  1772.    byte of the name the cursor is currently positioned on.
  1773.  
  1774.    Refer again to Figure 1-1.  Suppose you were positioned at the top of the
  1775.    file list, and held down [Shift] while pressing [e] three times in a row.
  1776. |  The cursor would move first to the "ETC" entry, then to "EDDY.COM", and
  1777. |  finally to the "ENVEDT.EXE".
  1778.  
  1779.    Speed search is disabled when option /F is ON.
  1780.  
  1781.    Speed search is also available for choosing directories from the directory
  1782.    tree display, as described in Section 5.3.2.
  1783.  
  1784.  
  1785.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 4-2
  1786.  
  1787.  
  1788.    4.2 Renaming Files
  1789.  
  1790.    Turn on option /F (explained in Section 2.2.1) if you want to rename files.
  1791.    If this method is used, speed search, as described above, is disabled;
  1792.    typing over the filename field renames the file.
  1793.  
  1794.    To rename a file without disabling speed search, first press [Ins].  This
  1795.    turns on /F only while the cursor remains on the current line; as soon as
  1796.    it moves to a new line, /F is reset.
  1797.  
  1798.    To rename a file, type the new name over the old on the screen.  A "*" will
  1799.    appear to the right of the extension, to remind you that a change has been
  1800.    made.  The file will be renamed on disk when you enter UPDATE mode.
  1801.  
  1802.    Any valid characters for filenames may be entered, including spaces (except
  1803.    the first character may not be a space).  Valid characters are any in the
  1804.    range 20h through 7Eh, except for these:  [ . " / \ :  | < > + = ; , ]
  1805.  
  1806.    Lower case letters are converted to upper case by DOS.  You can rename
  1807.    files with EDDY so that they can't be used with normal DOS commands, by
  1808.    using names containing embedded blanks.
  1809.  
  1810.    When you rename a file, after UPDATE it will be moved to its proper place
  1811.    in the display, according to the sort sequence then in effect.
  1812.  
  1813.    When you rename a file, but you have not yet UPDATEd, the new name is used
  1814.    in any situation involving comparison of directory entries in the working
  1815.    and target directories.  For example, when comparing timestamps for a COPY
  1816.    command, the comparison process will use the entry (if any) in the target
  1817.    with a name matching the NEW name shown for the current file.
  1818.  
  1819.  
  1820.    4.3 Changing Timestamps
  1821.  
  1822.    Dates are displayed in mmddyy, ddmmyy, or yymmdd format, depending on the
  1823.    use of DOS's "COUNTRY.SYS; times are displayed based on a 12-hour clock
  1824.    with an "a" or "p" to show a.m. or p.m.
  1825.  
  1826.    Only valid month/day/year combinations may be entered.  Hours in the range
  1827.    01 to 12 are accepted; minutes and seconds must be less than 60.  Seconds
  1828. |  must be even numbers -- a DOS limitation.  You can set the date and time to
  1829. |  all zeros.  If you do this, the timestamp will not display when you use the
  1830. |  DOS "DIR" command.  Useful to call attention to entries in a "DIR" listing.
  1831.  
  1832.    EDDY keeps an internal timestamp.  EDDY's internal timestamp is either the
  1833.    current DOS date and time, or a date and time which was set by pressing
  1834. |  [Alt+=].  Pressing [Alt+=] freezes EDDY's timestamp at the date and time of
  1835. |  the current file or directory entry, until changed by another [Alt+=].
  1836.  
  1837. |  When the timestamp is frozen, an "=" appears in the display heading line,
  1838. |  next to the word "time".
  1839.  
  1840.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 4-3
  1841.  
  1842.  
  1843. |  Pressing [=] puts EDDY's internal timestamp on the file.  Especially useful
  1844. |  for timestamping several files with the same value, as is often done when
  1845. |  preparing a software package for distribution.
  1846.  
  1847. |  [Alt+minus] undoes the effect of a previous [Alt+=]; i.e., tells EDDY to
  1848.    use the current DOS timestamp.
  1849.  
  1850.    When a change has been made to the date or time, an asterisk will appear in
  1851.    the line to the right of the field changed.
  1852.  
  1853.  
  1854.    4.4 Changing File Attributes
  1855.  
  1856.    Attribute bit settings are displayed under the heading "RHSDAN", indicating
  1857.           R)EAD-ONLY, H)IDDEN, S)YSTEM, D)IRECTORY, A)RCHIVE and N)ETWORK
  1858.    file attributes, respectively.
  1859.  
  1860.    Attributes may be displayed in two different styles.  Press [Tab] to toggle
  1861.    between these styles.  You may set the default style by customizing.  See
  1862.    Section 30.3.2e, the "attributes style" parameter, for more information.
  1863.  
  1864.    With either style, when the cursor is in the attributes field, pressing one
  1865.    of the attribute letters [R], [H], [S] or [A] (case doesn't matter) toggles
  1866.    the attribute setting between ON and OFF.
  1867.  
  1868.  
  1869.    4.4.1 Attributes Style #1
  1870.  
  1871.    In the display, a "." will appear in the column for an attribute that is
  1872.    OFF, and the letter of the attribute will appear if it is ON.  Figure 1-1
  1873.    is an example of this.
  1874.  
  1875.    To change an attribute setting to ON, type "+" or "y" in the corresponding
  1876.    column; to change the setting to OFF, type "-" or "n".
  1877.  
  1878.    When you type "y" or "n" in an attribute field, the attribute is marked as
  1879.    changed, and the cursor moves right, to the next attribute for that file.
  1880.    When you type "+" or "-", the cursor moves down to the next file's
  1881.    attribute field, in the same column.
  1882.  
  1883.    When an attribute has been changed to ON, a "+" will appear in that column.
  1884.    If it has been changed to OFF, a "-" will be shown.
  1885.  
  1886.    You can also change an attribute for all files in the working directory
  1887.    with a single command.  Move the cursor to the column of the attribute you
  1888.    want to change (the line the cursor is on doesn't matter unless option /L
  1889.    is ON) and press [^y] or [^n].
  1890.  
  1891.  
  1892.    4.4.2 Attributes Style #2
  1893.  
  1894.    If you choose this style, a "y" indicates the attribute is ON for this
  1895.    file; "n" means it is OFF.  Figure 1-2 is an example of this.
  1896.  
  1897.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 4-4
  1898.  
  1899.  
  1900.  
  1901.    Changing attribute settings works the same as for attributes style 1.  The
  1902.    only difference is that, when a change has been made to an attribute bit,
  1903.    that attribute will be displayed as a capital "Y" or "N" instead of
  1904.    lowercase.
  1905.  
  1906.  
  1907.    4.4.3 "Network-shareable" Attribute
  1908.  
  1909.    A number of users have asked about the "network-shareable" (formerly
  1910.    referred to as the "shared") attribute, as it is not included in most DOS
  1911.    reference books/manuals.
  1912.  
  1913.    In Novell's Netware -- and in other network software -- files are assigned
  1914.    a full 16-bit word of attributes.  These include the standard DOS
  1915.    attributes as a subset, using the corresponding DOS bit positions.  One of
  1916.    the network-unique attributes is "shared", and they use bit 7 of their
  1917.    attribute word for that.  To avoid conflict with the letter used for the
  1918.    DOS "system" attribute, and to remind the user that it's related to
  1919.    networks, EDDY calls it "network-shareable".
  1920.  
  1921.    When you use the DOS interrupt 21h "get attributes" service, and the file
  1922.    is on a networked drive, the "network redirector" mechanism returns the
  1923.    low-order byte of the network attribute word.  If the "network-shareable"
  1924.    bit happens to be ON, then it's passed through from DOS in that state, and
  1925.    thus reported by EDDY.  It can't normally be modified from DOS.  You COULD
  1926.    sector-patch it with EDDY, if you really wanted to.
  1927.  
  1928.    In systems where the shared attribute is used, it's a very important piece
  1929.    of information.  It means that the file is one which may be shared by
  1930.    several users on a network.
  1931.  
  1932.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 5-1
  1933.  
  1934.  
  1935.  
  1936.    5.  Moving to a New Directory
  1937.  
  1938.    You can change EDDY's working directory and/or target directory at any
  1939.    time. These may be on the same or different disks.
  1940.  
  1941.  
  1942.    5.1 Dialog Boxes or Tree Diagrams -- Your Choice
  1943.  
  1944.    You have a choice of selecting directories from a graphical tree diagram or
  1945.    by text entry, using a dialog box.  The tree diagram is generally easier to
  1946.    use, but the dialog box is needed in certain situations, described below.
  1947.    Also, there is a delay associated with the tree diagram the first time a
  1948.    disk is accessed (or each time, on a floppy).
  1949.  
  1950.    The dialog box entry method is needed if you want to change the file
  1951.    specification used to select files for inclusion in the working directory
  1952.    display (e.g., you want to use "*.CPP" rather than "*.*").  It is also
  1953.    needed if you want to create a new directory for use as the target.
  1954.  
  1955.  
  1956.    5.1.1 How to Choose
  1957.  
  1958.    To choose a new working or target directory, press [Alt+w] or [Alt+t],
  1959.    respectively.  [Alt+w] and [Alt+t] work identically, except for the
  1960.    directory they refer to.  For the remainder of this section any reference
  1961.    to [Alt+w] and the working directory also applies to [Alt+t] and the target
  1962.    directory.
  1963.  
  1964.    The first time you press [Alt+w], you'll see the dialog box for entry of a
  1965.    new working directory.  Press [Alt+w] while this box is displayed, and EDDY
  1966.    will switch to the tree diagram for working directory selection.
  1967.  
  1968.    Once you have requested the tree diagram, it will be considered your first
  1969.    choice for working directory selection.  Anytime you press [Alt+w] from the
  1970.    EDIT mode display, you will see the tree display, not the dialog box.
  1971.  
  1972.    If you want to switch your choice back to the dialog box, press [Alt+w]
  1973.    while the tree diagram is displayed.
  1974.  
  1975.    [Alt+w] may be toggled in this way as often as you wish.  If you customize
  1976.    your copy of EDDY (see Section 30), the default action for [Alt+w] will be
  1977.    set to the action (tree or box) in effect when you customize.
  1978.  
  1979.    You may use the dialog box anytime you want, regardless of the action
  1980.    setting then in effect for [Alt+w]; if you press [Shift] at the same time
  1981.    -- i.e., [Alt+Shift+w] -- the dialog box will always be displayed.  This
  1982.    does not affect the action setting for [Alt+w].
  1983.  
  1984.    REMEMBER: All references to [Alt+w] also apply to [Alt+t].
  1985.  
  1986.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 5-2
  1987.  
  1988.  
  1989.  
  1990.    5.1.2 Performance Considerations
  1991.  
  1992.    When EDDY scans a drive to determine the tree structure, you may save the
  1993.    scanned data in a file for later use (by pressing [F5]).  This has the
  1994.    advantage of faster display creation, but may be inaccurate if you have
  1995.    made changes to the directory structure since the file was created.
  1996.  
  1997.  
  1998.    a. Memory is Always Up-to-Date
  1999.  
  2000.    EDDY maintains the tree structure information for up to two drives in
  2001.    memory.  If a third drive's tree is requested, one of the memory areas will
  2002.    be reused, and any later access to the previous drive's tree will incur the
  2003.    initial delay again.
  2004.  
  2005.    If a tree data memory area is needed to be reused, an area associated with
  2006.    a floppy drive will be selected if possible.  This minimizes extra delays,
  2007.    as the tree data for floppy disks is refreshed with every reference anyway.
  2008.  
  2009.    If you use the DOS Gateway or Point & Shoot functions, EDDY has no way of
  2010.    knowing what changes may have been made.  Therefore, the tree information
  2011.    will be refreshed the next time the tree diagram is requested, and so
  2012.    you'll experience the delay again in this case, too.  Also, if you change
  2013.    the tree by creating new (target) directories, or by renaming, moving or
  2014.    deleting directories, the tree information must be refreshed.
  2015.  
  2016.    The maximum number of directories which EDDY can handle for one disk drive
  2017.    is difficult to specify, as it depends on how long the directory names are
  2018.    -- shorter names take less space.  However, if your drive has all 12-byte
  2019.    directory names (ffffffff.eee), 480 of them can be accommodated.
  2020.  
  2021.    The tree data may also be overwritten if you call on functions that need
  2022.    more memory, and the only way to get it is to use the memory where the tree
  2023.    data is stored.  Functions that MAY produce this condition are:  LOOK,
  2024.    UPDATE, HELP, and MENUs.
  2025.  
  2026.  
  2027.    b. Save a Tree - [F5]
  2028.  
  2029.    If you have directory structures (trees) that don't change very often,
  2030.    consider saving the tree data in a file.  For subsequent tree displays, the
  2031.    data from the file will be used, saving the normal scanning delay.
  2032.  
  2033.    Press [F5] while the tree diagram is displayed to save the data.  It will
  2034.    be saved in a file called "EDDYTREE.{x}", where "x" is the drive ID letter.
  2035.    This file will be stored in the root directory of the drive involved.  If
  2036.    you press [F5] again later, the file will be overwritten by the new data.
  2037.  
  2038.    When you ask for the tree diagram, the data from EDDYTREE.{x} will always
  2039.    be used to create the display if the file exists (and has not been corrup-
  2040.    ted).  If the file is used, you'll see "EDDYTREE.{x}" at the lower left
  2041.    corner of the screen.
  2042.  
  2043.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 5-3
  2044.  
  2045.  
  2046.  
  2047.    If you suspect that the tree data from the file might be out-of-date, you
  2048.    may refresh the display (a new tree structure scan) by pressing [^x], where
  2049.    "x" is the drive ID letter of the currently-displayed drive.
  2050.  
  2051.    Note that refreshing the displayed tree by pressing [^x] does NOT update
  2052.    the tree data file automatically.  Except when EDDY finds an
  2053.    already-existing, but out-of-date version of EDDYTREE.{x}, the file is
  2054.    updated only when you request it explicitly, by pressing [F5].
  2055.  
  2056.    If EDDY finds that the tree file is out-of-date (e.g., tree file doesn't
  2057.    include the DOS default directory on that drive), it will be rebuilt, and
  2058.    automatically updated on your disk.  Since the file was on your disk
  2059.    already, EDDY assumes you still want it.
  2060.  
  2061.  
  2062.    5.2 Directory Selection via Dialog Box
  2063.  
  2064.    To request the dialog box for entering working or target directories, press
  2065.    [Alt+Shift+w] or [Alt+Shift+t], respectively.
  2066.  
  2067.    Then enter the full path including drive and/or root, or a partial path
  2068.    that EDDY will interpret relative to the working or target directory, as
  2069.    appropriate.  If your entry includes a drive and root (e.g., "C:\WORK"),
  2070.    EDDY will use the specification exactly as you enter it.
  2071.  
  2072.    If you enter only a drive (e.g., "C:"), the DOS default directory for that
  2073.    drive will become the EDDY's (working or target) directory.  If the DOS
  2074.    default is not the root, it will be displayed before it is used.
  2075.  
  2076.    When typing a path, you may use [Ins] and [Del] to make changes to it.
  2077.  
  2078.    If you are working with exceptionally long path strings, they may be
  2079.    "abbreviated" in the display.  (See Section 1.4.1).  If the path you want
  2080.    to change (working or target directory) is abbreviated, it will not appear
  2081.    in the dialog box.
  2082.  
  2083.  
  2084.    5.2.1 Working Directory Dialog Box - [Alt+Shift+w] / [Alt+w]
  2085.  
  2086.    The working directory may be changed by pressing [Alt+Shift+w] (or [Alt+w],
  2087.    if that key is set to request the dialog box) and entering the new path,
  2088.    according to the rules described in the preceding paragraph.
  2089.  
  2090.    A file specification may also be entered, either with or without a path.
  2091.    If you enter only a file specification (e.g., "*.BAT"), that file
  2092.    specification will be used with the working directory.
  2093.  
  2094.    EDDY tries to use your specification as a path.  If no such path can be
  2095.    found, what you have entered is used as a file specification.
  2096.  
  2097.    If you start the name with a "\", EDDY interprets this as a directory path
  2098.    starting from the root of the working directory's drive.  If there's no
  2099.    initial "\", EDDY appends the name you provide to the end of the working
  2100.    directory path string, and uses that as the new directory.
  2101.  
  2102.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 5-4
  2103.  
  2104.  
  2105.  
  2106.    For example:  suppose your working directory is C:\UTIL and the DOS default
  2107.    on drive D: is D:\WORK.  After pressing [Alt+w], if you type...
  2108.           "\" or ".." the new working directory will be C:\
  2109.           "\FOO" the new   working directory will be C:\FOO
  2110.           "FOO" (or "C:FOO") the new working directory will be C:\UTIL\FOO
  2111.           "D:" the new working directory will be D:\WORK
  2112.           "D:FOO" the new working directory will be D:\WORK\FOO
  2113.  
  2114.    Also see Section 5.8 if you work with "SUBST"ed drives.
  2115.  
  2116.    If you change your working directory to the same as your target directory,
  2117.    the target directory specification in EDDY will be set to "no target".  If
  2118.    you then enter a COPY or MOVE command, EDDY will ask you for a new target.
  2119.  
  2120.    For other ways to change directories, see Section 5.5 (Exchange Working &
  2121.    Target Directories), 5.7 (Where's That File?) and 8.1 (LOOK at Directory).
  2122.  
  2123.  
  2124.    5.2.2 Target Directory Dialog Box - [Alt+Shift+t] / [Alt+t]
  2125.  
  2126.    The target directory may be changed by pressing [Alt+Shift+t] (or [Alt+t],
  2127.    if that key is set to request the dialog box).  EDDY will display the
  2128.    target drive and path (or tell you that there is no target) and allow you
  2129.    to change the target directory if you wish.
  2130.  
  2131.    If you don't want to enter a new target directory after pressing
  2132.    [Alt+Shift+t], press [Esc].  The target directory will remain unchanged.
  2133.  
  2134.    No file specification may be used in the target directory path
  2135.    specification; only a drive and path are allowed.  The target directory
  2136.    cannot be set the same as the working directory.
  2137.  
  2138.    Partial path specifications are interpreted exactly as described above, for
  2139.    working directories, if there is no target.  If there is a target, partial
  2140.    paths are interpreted relative to it.
  2141.  
  2142.    If you start the name with a "\", EDDY interprets this as a directory path
  2143.    starting from the root of the target directory's drive.  If there's no
  2144.    initial "\", EDDY appends the name you provide to the end of the target
  2145.    directory path string, and uses that as the new directory.
  2146.  
  2147.    For example:  suppose your target directory is C:\TGT and the DOS default
  2148.    on drive D: is D:\EASY.  Then, after pressing [Alt+Shift+t], if you
  2149.    type...
  2150.           "\" or ".." the new target directory will be C:\
  2151.           "\MONEY" the new target directory will be C:\MONEY
  2152.           "MONEY" (or "C:MONEY") the new target directory will be C:\TGT\MONEY
  2153.           "D:" the new target directory will be D:\EASY
  2154.           "D:MONEY" the new target directory will be D:\EASY\MONEY .
  2155.  
  2156.    If you enter a target directory name that doesn't exist after pressing
  2157.    [Alt+Shift+t] or [Alt+x], EDDY will normally ask if you want to create a
  2158.    new directory.  However, if any parts of the path preceding the name of the
  2159.    directory are also invalid, you will just get an error message.
  2160.  
  2161.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 5-5
  2162.  
  2163.  
  2164.  
  2165.    5.2.3 Target Tracking - [=]
  2166.  
  2167.    Target tracking is the feature that tells EDDY to automatically change the
  2168.    target directory according to changes you make to the working directory.
  2169.  
  2170.    This feature makes it easy to synchronize directories on different disks
  2171.    when the disks have similar tree structures at upper levels, but differ at
  2172.    deeper levels in the tree.  For example, suppose you have a setup such as:
  2173.  
  2174.      C:\
  2175.        BAT
  2176.        DOS
  2177.        DRIVERS                           and a diskette
  2178.        UTIL                              on which you have:
  2179.        PERSONAL
  2180.          FINANCE                              A:\
  2181.          ADDRESS                                ADDRESS
  2182.          LETTERS                                LETTERS
  2183.            BUSINESS                               BUSINESS
  2184.            FRIENDS                                FRIENDS
  2185.          RESUME
  2186.        ETC
  2187.          GAMES
  2188.          PICTURES
  2189.          HUMOR
  2190.        ...and so on
  2191.  
  2192.    If your working directory is C:\PERSONAL and your target is A:\, you could
  2193.    use target tracking to synchronize corresponding directories.  To select
  2194.    target tracking, press [=] and then [Enter] while the target directory
  2195.    dialog box is on screen.  Note that you cannot select target tracking
  2196.    unless there is a target directory in effect already.
  2197.  
  2198.    Now, if you press [F3] (or [Enter]) on the ADDRESS entry in the EDIT mode
  2199.    display, A:\ADDRESS will automatically become the new target.  If you then
  2200.    press [F3] on the ".." entry, the target will be A:\ again.  Press [F3] on
  2201.    the LETTERS entry, and the target changes to A:\LETTERS.
  2202.  
  2203.    As long as you use [F3] (or [Enter]) to change working directories, AND
  2204.    there are corresponding directories in the target disk's directory tree,
  2205.    the target will follow ("track") the working directory changes.
  2206.  
  2207.    If you select a new working OR target directory by using the dialog box or
  2208.    tree selection methods, directory tracking will be turned off.  Similarly,
  2209.    it will be turned off if you move to a working directory that doesn't have
  2210.    a corresponding directory on the target disk (such as C:\PERSONAL\FINANCE
  2211.    in the example above).
  2212.  
  2213.    When "target tracking" is in effect, the display will show "Target=" in the
  2214.    lower right-hand corner, instead of the normal "Target:".
  2215.  
  2216.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 5-6
  2217.  
  2218.  
  2219.  
  2220. |  5.2.4 Cancel Target
  2221. |
  2222. |  There are two ways to cancel a target directory:
  2223. |
  2224. |  - Make it your working directory, using any key (sequence) other than
  2225. |    [Alt+x] -- e.g., [F3], or [Alt+w], etc.
  2226. |
  2227. |  - Press [Alt+t] -- or [Alt+Shift+t], if you're set up to use the tree
  2228. |    diagram for target selection -- followed by [.] and [CR].
  2229.  
  2230.  
  2231.    5.3 Directory Selection from Tree Diagram
  2232.  
  2233.    To request the tree diagram for the working directory's drive, press
  2234.    [Alt+w]; for the target directory's drive, [Alt+t].  If you get the dialog
  2235.    box display, press [Alt+w] or [Alt+t], respectively, again.
  2236.  
  2237.  
  2238.    5.3.1 Tree Display Format
  2239.  
  2240.    In the tree diagram, four types of directories are distinguished:
  2241.  
  2242.         - The DOS default directory is shown in "braces", like {THIS}.
  2243.  
  2244.         - The working directory is shown enclosed in the special "double
  2245.           angle-brackets" characters, and looks something like <<THIS>>.
  2246.  
  2247.         - The target directory has solid triangle characters pointing to it on
  2248.           either side.  These characters are unprintable on many printers, and
  2249.           are not shown here.  They will be obvious in the display.
  2250.  
  2251.         - Other directories have no special characters enclosing them.
  2252.  
  2253.    The working/target directory will be highlighted when the tree is
  2254.    displayed.  To select a new directory, move the highlight to it and press
  2255.    [Enter] (or left-click the mouse).
  2256.  
  2257.  
  2258.    5.3.2 Moving the Tree Highlight (Speed Search)
  2259.  
  2260.    The highlight may be moved with the mouse, the cursor keys, or by using the
  2261.    "speed search" feature.
  2262.  
  2263.    The mouse and cursor keys work generally as you'd expect.  However, note
  2264.    that a [Right] arrow or mouse move always moves to the next directory in
  2265.    the tree.  Repetitions of [Right] will eventually visit every directory in
  2266.    the tree -- a complete "tree walk".  When the highlight is on the last
  2267.    directory in the tree, another [Right] will wrap back to the root.
  2268.  
  2269.    A [Left] arrow or mouse move goes to the parent of the currently
  2270.    highlighted directory.  Repeated [Left]s will quickly return to the root.
  2271.  
  2272.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 5-7
  2273.  
  2274.  
  2275.  
  2276.    To move the highlight, just start typing the directory name you want to
  2277.    select.  This is the speed search feature.  Speed search works the same way
  2278.    it does for directory displays in EDIT mode, as described in Section 4.1.
  2279.    (Except that option /F has no effect).
  2280.  
  2281.    A cursor within the highlight shows where the next character typed will be
  2282.    placed (just as in EDIT mode).  This cursor is not moved by using the
  2283.    cursor keys; they move the highlight, as described above.  The cursor moves
  2284.    right one column for each character typed.  Press [BackSpace] to move left.
  2285.  
  2286.    After positioning the highlight, press [Enter] to select a directory as the
  2287.    new work or target.  Alternatively, press [Alt+F10].  [Alt+F10] tells EDDY
  2288.    to terminate, leaving the selected drive/directory as the new DOS default.
  2289.  
  2290.  
  2291.    5.3.3 Moving to a New Drive - [^letter] / [\]
  2292.  
  2293.    If you press [\] or [^\], you'll get a list of valid drives to choose from.
  2294.    Either press a letter from the list, or move the cursor to the desired
  2295.    drive letter and then [Enter] or left-click.
  2296.  
  2297.    The actions resulting from using [\] depend on what is on screen when you
  2298.    press it, and whether you are currently using directory selection via
  2299.    dialog box or via tree diagram.
  2300.  
  2301.         1.  Tree diagram on screen:  The drive list will pop up on top of the
  2302.         tree display.  When you choose a drive from the list, the tree for
  2303.         that drive will be displayed.
  2304.  
  2305.         2.  EDIT mode display on screen, directory selection via tree diagram:
  2306.         The diagram for the working directory's drive will be displayed.  When
  2307.         you choose a drive from the list, the tree for that drive will be
  2308.         displayed.
  2309.  
  2310.         3.  EDIT mode display on screen, directory selection via dialog box:
  2311.         The drive list will pop up on top of the EDIT display.  Choosing a
  2312.         drive from the list changes the working directory selection mode to
  2313.         "via tree diagram" (just as though you had pressed [Alt+w] twice,
  2314.         followed by [\]), and then the tree for the drive you chose will be
  2315.         displayed.
  2316.  
  2317.         4.  Working directory dialog box on screen:  The tree diagram for the
  2318.         working directory's drive will be displayed.  You will now be in tree
  2319.         diagram mode for any subsequent working directory selection.  (This is
  2320.         the same result as pressing [Alt+w] while the box is displayed).  The
  2321.         drive list will pop up on top of the tree display.  When you select a
  2322.         drive from the list, the tree for that drive will be displayed.
  2323.  
  2324.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 5-8
  2325.  
  2326.  
  2327.  
  2328.         5.  Target directory dialog box on screen:  The tree diagram for the
  2329.         target directory's drive will be displayed.  You will now be in tree
  2330.         diagram mode for any subsequent target directory selection.  (This is
  2331.         the same result as pressing [Alt+t] while the box is displayed).  The
  2332.         drive list will pop up on top of the tree display.  When you select a
  2333.         drive from the list, the tree for that drive will be displayed.
  2334.  
  2335.    While the tree diagram is displayed, diagrams for other drives may be
  2336.    displayed by pressing [Ctrl] and the drive letter identifier; e.g., to get
  2337.    the tree display for drive C:, press [^c].
  2338.  
  2339.    To go directly to the tree diagram for any valid drive from the dialog box,
  2340.    press [^letter] while the working directory dialog box is on-screen; the
  2341.    action is just as though you had pressed [Alt+w], followed immediately by
  2342.    [^letter].  That is, you'll get the tree display for the drive, and any
  2343.    subsequent use of [Alt+w] from EDIT mode will yield the tree display rather
  2344.    than the dialog box.  [^letter] pressed while the target directory dialog
  2345.    box is on-screen works similarly.
  2346.  
  2347.  
  2348.    5.3.4 Working Directory Tree - [Alt+w]
  2349.  
  2350.    With the tree diagram displayed, move the highlight to the name of the
  2351.    directory you wish to become the working directory, and press [Enter] (or
  2352.    left-click).  The highlighted directory will become the new working
  2353.    directory.
  2354.  
  2355.    If you change your working directory to the same as your target directory,
  2356.    the target directory specification in EDDY will be set to "no target".  If
  2357.    you then enter a COPY or MOVE command, EDDY will ask you for a new target.
  2358.  
  2359.    When you display the tree diagram for the working directory's drive, you
  2360.    will NOT see the DOS default directory for that drive enclosed in "{ }".
  2361.    This is because EDDY always changes the DOS default directory on the
  2362.    working directory's drive to be the same as EDDY's working directory while
  2363.    EDDY is in control.  When you exit from EDDY, the DOS default directory
  2364.    that was in effect when you started EDDY is restored as the default
  2365.    (normally -- see Section 16 for more information).
  2366.  
  2367.    If you display the tree for another drive (e.g., by pressing [^c]) you WILL
  2368.    see the DOS default directory on that drive.  If the working directory is
  2369.    on a SUBST'ed drive which is part of the new drive's tree structure, both
  2370.    the {DEFAULT} and <<WORKING>> directories will be indicated.
  2371.  
  2372.  
  2373.    5.3.5 Target Directory Tree - [Alt+t]
  2374.  
  2375.    With the tree diagram displayed, move the highlight to the desired
  2376.    directory name and press [Enter] (or left-click).  The highlighted
  2377.    directory will become the new target directory.
  2378.  
  2379.    You may not select a target directory the same as the working directory.
  2380.  
  2381.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 5-9
  2382.  
  2383.  
  2384.  
  2385.    If you press [Alt+t] with no target directory previously selected, the tree
  2386.    diagram for the working directory will be displayed.
  2387.  
  2388.  
  2389.    5.4 Directory Selection from Drive List - [\]
  2390.  
  2391.    Press [\] from EDIT mode to display a list of valid drives.  Choose a drive
  2392.    from this list -- by typing the letter, or "clicking" on it -- and the
  2393.    working directory will be changed as follows:
  2394.  
  2395.    If the drive you choose is different from your working directory's drive,
  2396.    the new working directory will be set to the DOS default directory on the
  2397.    chosen drive.
  2398.  
  2399.    If the drive you choose is the same as your working directory's drive, the
  2400.    new working directory will be the root directory on that drive. (If your
  2401.    working directory was already the root, there'll be no change).
  2402.  
  2403.  
  2404.    5.5 Exchange Working & Target Directories - [Alt+x]
  2405.  
  2406.    To exchange the working and target directories, press [Alt+x] (This turns
  2407.    off option /W if it is on -- see Section 5.7).  When you exchange, EDDY
  2408.    will "remember" your current file, and will return the cursor to that file
  2409.    if you later exchange back (with no intervening changes of directory).
  2410.  
  2411.  
  2412.    5.6 Directory Recall - [Shift+F10], [Shift+^F10]
  2413.  
  2414.    Directory recall may be set for the current working directory by pressing
  2415.    [Shift+F10].  This directory may later be "recalled" as the working
  2416.    directory by pressing [Shift+^F10].  See Section 16.1.
  2417.  
  2418.  
  2419.    5.7 Where's That File?  - Option /W and [^w]
  2420.  
  2421.    To find the directory (or directories) a file is in, use option /W from the
  2422.    command line and/or the [^w] command within EDDY.
  2423.  
  2424.    For example, enter:  EDDY/W  C:\FOO*.*  to search drive "C:" for any file
  2425.    beginning with "FOO", with any extension.  If a directory is found that
  2426.    contains such a file, it will be set as the working directory.  Press [^w]
  2427.    to find the next such directory, if any.
  2428.  
  2429.    If you enter:  EDDY/W "+06/15/91"  EDDY will search the directory tree
  2430.    starting from DOS's default directory, and will stop when a file is found
  2431.    that was created after the indicated date (see "Filtering by Timestamp").
  2432.  
  2433. |  Similarly,  EDDY/W +H  will find any "hidden" files.
  2434.  
  2435. |  See Section 18 for more on filtering by timestamps and/or file attributes.
  2436.  
  2437.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 5-10
  2438.  
  2439.  
  2440.  
  2441.    From the command line, using option /W causes EDDY to search the disk for
  2442.    matching files, starting with the given working directory and continuing
  2443.    downward in the directory tree.  The directories are searched in "unsorted"
  2444.    sequence; i.e., the order they actually are stored on your disk.  The
  2445.    working directory which will be displayed is the first one found which has
  2446.    matching files.  If there is no match, you'll get "File not found".
  2447.  
  2448. |  Pressing [^w] when option /W is off turns /W on, and you will be asked for
  2449. |  a file specification to use in the search.  EDDY then searches from the
  2450.    working directory downward in the tree for a directory with one or more
  2451.    files matching the current file, attribute and/or timestamp specifications
  2452. |  (i.e., if you want filtering to be used as part of your search criteria,
  2453. |  set the filters before pressing [^w]).  If found, that directory becomes
  2454.    the new working directory.  If there are no matches, you'll get "File not
  2455.    found", and /W is turned off.
  2456.  
  2457. |  When beginning the search, if there are some subdirectories in the working
  2458. |  directory that you don't want to include in the search, tag those with
  2459. |  "Ignore", by pressing [Alt+F7], before pressing [^w].
  2460.  
  2461. |  Pressing [^w] when option /W is on causes EDDY to continue searching the
  2462.    directory tree for the next directory, relative to the working directory in
  2463.    use when you first pressed [^w], which contains matching files.  Using [^w]
  2464.    again will display the next directory, if any, which has matching files.
  2465.  
  2466.    Explicitly changing working directory (by using [F3], [Alt+x], [Alt+w],
  2467.    or [Alt+Shift+w] will turn off option /W.
  2468.  
  2469.  
  2470. |  5.7.1 Found It!  Make a List File - [Alt+l] / [^l]
  2471. |
  2472. |  In many cases, "Where's That File?" is even more powerful when combined
  2473. |  with the use of "list files".  See Section 22 for more details on list
  2474. |  files, and to supplement the following discussion.
  2475. |
  2476. |  If you have found the file(s) you're searching for, you may write the
  2477. |  filenames to a list file by pressing [Alt+l] if you don't plan to search
  2478. |  in more directories or if you want the filenames from each directory to be
  2479. |  written to a separate list file.
  2480. |
  2481. |  If you want to write the filenames and then keep searching, adding more
  2482. |  filenames to the same list file as you go, use [^l] in the first directory
  2483. |  (to open a "persistent" list file), and then press [Alt+l] to add filenames
  2484. |  in any other directories that are appropriate.
  2485. |
  2486. |  Within each directory where matching files are located, if there are some
  2487. |  selected filenamess that you do not want to include in the list file, tag
  2488. |  those files as "Ignore" -- by pressing [Alt+F7] -- before pressing [Alt+l].
  2489.  
  2490.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 5-11
  2491.  
  2492.  
  2493.  
  2494.    5.8 Working With "SUBST"ed Directories
  2495.  
  2496.    EDDY can switch freely between SUBST'ed drives and subdirectories and their
  2497.    un-SUBST'ed, fully expanded path equivalents.
  2498.  
  2499.  
  2500.    5.8.1 From the Command Line
  2501.  
  2502.    Suppose your current DOS default drive is actually SUBST'ed, and you are in
  2503.    the highest level directory of that SUBST'ed drive (i.e., what is
  2504.    effectively the "root" directory for that drive).  In this case, if you
  2505.    specify either the working or target directory as "..", the true drive and
  2506.    path will be used.
  2507.  
  2508.    For example, if you earlier used the DOS command "SUBST X:  C:\FOO\BAR" and
  2509.    your DOS default drive is "X:", using ".." will be interpreted by EDDY as
  2510.    "C:\FOO".  If your DOS default is "X:\WORK", EDDY would interpret ".." the
  2511.    same way DOS does -- i.e., "X:\".
  2512.  
  2513.  
  2514.    5.8.2 Interactively
  2515.  
  2516.    Once EDDY is executing, if you change directories as described in Sections
  2517.    5.1 - 5.5, or by using [F3] as described in Section 8.1, you have even more
  2518.    flexibility with SUBST'ed drives.
  2519.  
  2520.    Using ".." works the same as it does on the command line, as described in
  2521.    the preceding section.
  2522.  
  2523.    However, "." used from within EDDY is interpreted as the un-SUBST'ed, fully
  2524.    expanded path string.  Thus, using the example in the preceding section, if
  2525.    your working directory is "X:\WORK" and you use ".", EDDY will interpret
  2526.    this as "C:\FOO\BAR\WORK".
  2527.  
  2528.    This is only a change in the way the directory is referenced; it is the
  2529.    same physical directory no matter which string is used to refer to it.
  2530.    Therefore, the display of files, bytes used, etc., will not be affected.
  2531.  
  2532.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 6-1
  2533.  
  2534.  
  2535.    6.  HELP When You Need It - [F1]
  2536.  
  2537.    When you have a choice to make as to how you want EDDY to proceed, you can
  2538.    get relevant HELP information by pressing [F1].  The HELP screen you get
  2539.    will be different, depending on what you were doing when you pressed [F1].
  2540. |  As an alternative to pressing [F1], you may use the mouse:  click the left
  2541. |  and right mouse buttons within the double click time interval.
  2542.  
  2543.    Once you are in HELP mode, pressing [F1] displays the menu of available
  2544.    topics.  You may select from the menu, or press [PgUp] or [PgDn] to view
  2545.    the screens sequentially.  Or, if you choose the highlighted "Topic Search
  2546.    by Keyword", you may search for HELP information on any topic you require.
  2547.    See Section 6.2 for more about keywords.
  2548.  
  2549.    For the HELP function to operate, EDDY must be able to find the file
  2550.    "EDDY.AUX".  EDDY can find it in any of the following directories:
  2551.  
  2552.    - The directory you executed EDDY from (if you have DOS 3.0 or higher)
  2553.    - A directory which is mentioned in your DOS PATH statement
  2554.    - The working directory
  2555.  
  2556.    The initial HELP display, which appears when you type just "EDDY" with
  2557.    nothing else on the command line, does not appear if you use a customized
  2558.    or registered copy of EDDY (see Sections 30 and 31), or if you run a copy
  2559.    that has been renamed.  However, if EDDY is run on a machine that appears
  2560.    to be different from the one where the customizing was done, the initial
  2561.    HELP is re-enabled.
  2562.  
  2563.    EDDY loads the HELP module from EDDY.AUX when you press [F1], if there is
  2564.    enough memory available (around 65K).
  2565.  
  2566.    The HELP screens and menus have their own color attributes, not tied to
  2567.    those used for other EDDY screens (but HELP colors are the same as menu
  2568.    colors).  These colors may be customized as desired (see Section 30.2).
  2569.  
  2570.  
  2571.    6.1 HELP for Warnings and Other Messages
  2572.  
  2573.    Most of EDDY's messages can readily be understood from their wording and
  2574.    context.  For those that seem worthy of a bit more explanation, however,
  2575.    Appendix B of this document offers further information.  When there is more
  2576.    information provided in Appendix B, a message to that effect will appear
  2577.    beneath the warning or error message on the screen.
  2578.  
  2579.    6.2 Topic Search by Keyword
  2580.  
  2581.    When viewing HELP screens, pressing [F1] again displays the HELP Topic Menu
  2582.    with "Topic Search by Keyword" highlighted.  Press [Enter] and you'll get a
  2583.    screen which allows you to enter keywords (maximum: 5) of your choice.
  2584.  
  2585.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 6-2
  2586.  
  2587.  
  2588.  
  2589.    From other parts of EDDY, when you would normally press [F1] to get HELP,
  2590.    you may use [Shift+F1] instead.  If you do this, you will go directly to
  2591.    the keyword entry screen, rather than to the HELP screen that would
  2592.    normally be displayed in that situation (i.e., context-sensitive HELP is
  2593.    overridden by pressing [Shift+F1]).
  2594.  
  2595.    If you double click on the HELP button, HELP's keyword search screen will
  2596.    appear, just as if you had pressed [Shift+F1].
  2597.  
  2598.    EDDY will use your keywords to search through the text of all of the (40+)
  2599.    available HELP screens (screen titles are not included in the search).  The
  2600.    search is not case-sensitive; e.g., "Disk Image" = "disK imagE".
  2601.  
  2602.    Keyword search is based on complete words, NOT strings (unlike EDDY's FIND
  2603.    command in LOOK mode).  This means, for example, that the keyword "direct"
  2604.    would match only that word; it would not match "directory" or "direction".
  2605.  
  2606.    EDDY will display the first screen that matches your keyword(s), and any
  2607.    others that matched are available by pressing [PgDn] or [PgUp].  All lines
  2608.    containing one or more of the keywords that were used will be displayed in
  2609.    reverse video.  After the first matching page is displayed, anytime you
  2610.    display that same page again, a "beep" will sound.
  2611.  
  2612.    If you separate your keywords by spaces or commas, the search will require
  2613.    that ALL keywords be matched in order for a screen to be selected -- i.e.,
  2614.    the keywords are AND'd.  To OR the keywords, use "|" (the DOS "piping"
  2615.    symbol) as a separator.  Then, any one of the keywords matching is enough
  2616.    to select the screen.  ANDs and ORs may not be mixed.
  2617.  
  2618.    Keywords you enter may contain any characters except space, comma or "|".
  2619.  
  2620.    When searching the HELP screen text, in addition to spaces, commas and
  2621.    "|"s, EDDY normally considers the following characters to be "separators",
  2622.    which are not part of any word in the HELP text:
  2623.                         . : ; " ? / \ = + ! & % ( ) [ ] #
  2624.  
  2625.    However, if you include any of these as part of a keyword you enter, it
  2626.    will NOT be treated as a separator when searching the HELP text; i.e., if
  2627.    you enter "sh+f8" or "[sh+f8]", the result will be the same.  Also, if you
  2628.    enter "sh f8", the same set of screens will be displayed, but more lines
  2629.    would be in reverse video because some lines contain "sh" without the "f8".
  2630.  
  2631.    Similarly, entering "eddy.use" will retrieve a subset of the screens that
  2632.    would result if you entered "eddy" and "use" ("eddy use", without the
  2633.    quotes).  But if you entered "eddy" and "use" separated by the "piping"
  2634.    symbol ("eddy | use"), you would get many more screens.
  2635.  
  2636.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 7-1
  2637.  
  2638.  
  2639.  
  2640.    7.  UNDO Command - [F2], [^F2]
  2641.  
  2642.    Any changes requested may be "Undone" as long as they have not yet been
  2643.    written to disk by entering UPDATE mode.  To undo changes on the current
  2644.    file, press [F2].  To undo all changes for all files, press [^F2].
  2645.  
  2646.  
  2647.    7.1 Partial UNDO
  2648.  
  2649.    You may UNDO the COPY, MOVE, DELETE and DESTROY commands without affecting
  2650.    other changes pending for the file.  Just press the key for the same
  2651.    command again;  i.e., if a file is tagged for COPY, and you decide not to
  2652.    COPY, press [F5] and the tag will disappear, but other changes will remain.
  2653.  
  2654.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 8-1
  2655.  
  2656.  
  2657.  
  2658.    8.  LOOK Command - [F3], [^F3]
  2659.  
  2660.    LOOK has three variations, depending upon where the cursor is.  If the
  2661.    current line has a subdirectory, the request is interpreted as "display the
  2662.    contents of this subdirectory".  For normal files, LOOK means "display the
  2663.    contents of this file".  If the "Drive X:  is..." heading line is under the
  2664.    cursor, LOOK means "treat the entire disk as a file, and display it".
  2665.  
  2666.  
  2667.    8.1 LOOK at Subdirectory
  2668.  
  2669.    When you LOOK at a subdirectory, you change EDDY's working directory.  To
  2670.    do this, move the cursor to the display line of the directory you want to
  2671.    LOOK at and press [F3].  Changing directories with [F3] turns off option /W
  2672.    if it is on.  For other ways to change working directory, see Section 5.
  2673.  
  2674.    Figure 8-1 might have been reached from the display in Figure 1-1, as
  2675.    follows:  1) turn on option /R, to get " memory" in the display; 2) move
  2676. |  cursor to the subdirectory "SYS", and press [F3].
  2677.  
  2678. ================================================================================
  2679. filename.ext      size  mmddyy     time   RHSDAN
  2680. DIR of C:\SYS\*.*                                                              |
  2681. Drive C: "John's Disk"       11 files,      8192 bytes,   104247296 bytes free |
  2682.                                             3142 bytes wasted, cluster = 4096  |
  2683. .            <DIR>     12-23-95  5:30:50p ...D..           |======|            >
  2684. ..           <DIR>     12-23-95  5:30:50p ...D..           | MENU |            |
  2685. CARDWARE     <DIR>     12-23-95  5:53:08p ...D..           |======|            |
  2686. CDROM        <DIR>     12-23-95  5:54:00p ...D..           [Alt+F1]            |
  2687. DOS          <DIR>     12-23-95  5:30:52p ...D..                               |
  2688. DUBLDISK     <DIR>     12-23-95  6:08:14p ...D..           |======|            |
  2689. PCMCIA       <DIR>     12-24-95 10:52:34a ...D..           | HELP |            |
  2690. THINKPAD     <DIR>     12-23-95  5:54:06p ...D..           |======|            |
  2691. RAMBOOST INI      3716 11-17-94  1:00:00p ....A.             [F1]              |
  2692. RAMSETUP INI      1334 11-17-94  1:00:00p ....A.                               |
  2693.  memory         655360  1-19-76  1:08:29a                  |======|            |
  2694.         . . . . . . . . . . . . . . . . . .
  2695.                                                                   Target: none |
  2696. -EDIT- seq=N  [F2]:UNDO  [F3]:LOOK  [F5]:COPY  [F6]:MOVE  [F7]:DELETE  [F9]:DOS
  2697. ================================================================================
  2698.  
  2699. |                                 Figure 8-1
  2700.  
  2701.    To go to the parent directory of the working directory, move the cursor to
  2702.    the line containing ".." and press [F3] or [Home].  In our example, this
  2703. |  would produce the display of Figure 1-1 again.
  2704.  
  2705.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 8-2
  2706.  
  2707.  
  2708.  
  2709.    Using [F3] to change directories turns off option /W if it is on.
  2710.  
  2711.    If you move to a new working directory with changes pending (renames,
  2712.    copies, etc., which have not been through an UPDATE), the changes will be
  2713.    discarded -- in effect, Undone.  If there are pending changes, EDDY will
  2714.    warn you and ask for confirmation before moving to the new directory.
  2715.  
  2716.    Also see Section 5.8 if you work with "SUBST"ed drives.
  2717.  
  2718.    If there are no changes pending, pressing [Enter] will have the same effect
  2719.    as pressing [F3] if you are positioned on a file, directory or "drive"
  2720.    entry in the display; i.e., you will LOOK at that entry.  On other display
  2721.    lines, you'll get the usual "Nothing to update" message.  [Enter] always
  2722.    initiates an UPDATE if changes are pending, or if you are customizing EDDY.
  2723.  
  2724.    Note that the third box on the right side of the screen shows "LOOK" as the
  2725.    action corresponding to [Enter] if there are no changes pending; if there
  2726.    are, the box says "UPDATE".
  2727.  
  2728.    If you don't like the use of [Enter] as an alternate way to LOOK, see the
  2729.    description of the "easy look" configuration parameter in Section 30.3.2e.
  2730.  
  2731.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 8-3
  2732.  
  2733.  
  2734.  
  2735.    8.2 LOOK at File Contents (in Working Directory)
  2736.  
  2737.    To LOOK at the data contained in the current file, press [F3].  [^F3] LOOKs
  2738.    at the data in ALL files in the directory, one at a time.  Pressing [Esc],
  2739.    or pressing [F3] a second time, returns you to EDIT mode.
  2740.  
  2741.  
  2742.    8.2.1 LOOK Mode Commands
  2743.  
  2744.    a. Hex/ASCII Format Control - [Tab], [Shift+Tab]
  2745.  
  2746.    EDDY uses the first 512 bytes in a file to decide how to display the data
  2747.    (hex or ASCII format).  ASCII is used if at least 80% of the first 512
  2748.    bytes are printable (20h - 7Eh), formatting control characters -- CR, LF,
  2749.    FF, TAB -- or line/box-drawing characters.  Otherwise, hex format is used.
  2750.  
  2751.    [Tab] toggles between ASCII and hex display formats.  If you don't like
  2752.    that key, press [Shift+Tab].  EDDY will ask you to press the key you want
  2753.    to use as a toggle.  Any function key or [Alt]-shifted key that doesn't
  2754.    conflict with other LOOK, PATCH or FIND usage is OK.  E.g., [F5] and [F12]
  2755.    are OK, but [F1] (the "HELP" key) is not; [Alt+h] is OK, but [Alt+b] (used
  2756.    for bit-stripping) isn't.  If [Tab] is not used to toggle, it may be used
  2757.    in PATCH and FIND to enter TAB characters (see Sections 9 and 17).
  2758.  
  2759.    As a convenience to users accustomed to earlier versions of EDDY, [Ins]
  2760.    works identically to [Tab].  [Ins] ALWAYS works, even if you have changed
  2761.    the toggle key from [Tab] to something else.
  2762.  
  2763.  
  2764.    b. Printing a File - [Alt+p] / [^p]
  2765.  
  2766.    Pressing [Alt+p] prints the current file.  Printing begins with the line at
  2767.    the top of the screen, and continues until a key is pressed.  With a
  2768.    non-ASCII file, it's probably a good idea to ensure it's "printable", by
  2769.    pressing [p] before [Alt+p].  See Section 8.2.5a for more on this.
  2770.  
  2771.    For more details on printing (or sending the print output to a file, using
  2772.    [^p]), please see Section 21.
  2773.  
  2774.  
  2775.    c. EGA/VGA Screen Control - [e]
  2776.  
  2777.    If you have an EGA (or VGA) monitor, you may switch between 25 lines per
  2778.    screen and 43 (or 50) lines by pressing [e].  This is the same as turning
  2779.    option /E ON or OFF (see Section 2.2.1).
  2780.  
  2781.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 8-4
  2782.  
  2783.  
  2784.  
  2785.    8.2.2 ASCII Format Display
  2786.  
  2787.    In ASCII format, a new line is initiated when either a CR or LF is
  2788.    encountered (but a CRLF pair only counts as one line).  The line number of
  2789.    the line at the top of the screen is shown on the status line at the bottom
  2790.    of the screen.  The highest line number EDDY can display is 999,999.
  2791.  
  2792.    The "arrow" (and related) keys work a little differently in LOOK mode.  The
  2793.    display may be thought of as a "window" which can be moved around to view
  2794.    various parts of a file, while the file itself does not move.
  2795.  
  2796.    The keys used to move the display window around in ASCII format are:
  2797.  
  2798.     [Up]        - move up 1 line         [Down]   - move down 1 line
  2799.     [PgUp]      - move up 1 page         [PgDn]   - down 1 page
  2800.     [^Home]     - first page*            [^End]   - last page*
  2801.     [Left]      - left 1 column          [Right]  - right 1 column
  2802.     [left bracket] - tab left 20 columns [right bracket] - tab right 20 cols
  2803.     [^Left]     - left edge (col. 1)     [^Right] - right edge (last column)
  2804.     [Home]      - same as [^Left]        [End]    - same as [^Right]
  2805.     [^PgDn]     - auto-scroll down       [^PgUp]  - auto-scroll up
  2806.  
  2807.    [PgUp] and [PgDn] move a screen at a time, overlapping the previous screen
  2808.    by one line.  When paging in ASCII format through a long non-text file,
  2809.    EDDY may spend a lot of time looking for CRs and LFs that aren't there.  If
  2810.    EDDY appears to be "hung up" after a [PgUp] or [PgDn], press [^c] or
  2811.    [BackSpace] to interrupt the processing and display the file from wherever
  2812.    EDDY has reached, and no further processing will take place.
  2813.  
  2814.    If you just want to pause temporarily, to look at the screen or think about
  2815.    what's going on, press and hold [ScrollLock].  All processing will stop.
  2816.    Release the key to continue.
  2817.  
  2818.    The effect of the [Up] and [Down] keys in LOOK mode may be modified by
  2819.    pressing [s].  [s] toggles these keys between their normal scrolling effect
  2820.    of one-line-per-keypress and half-page-per-keypress ("speed scrolling").  A
  2821.    half page is defined by the number of text lines in the display, not the
  2822.    physical lines available on your screen.  Thus, the speed of scrolling will
  2823.    vary, depending on the data you're LOOKing at.
  2824.  
  2825.    Speed scrolling is of limited value unless you're using a mouse.  With a
  2826.    mouse, it gives a faster way of scrolling, without requiring use of the
  2827.    keyboard to press [PgUp]/[PgDn].
  2828.  
  2829.    Auto-scroll moves the display up or down continuously, without further key
  2830.    presses.  It is started by [^PgDn] or [^PgUp].  Pressing the same key again
  2831.    speeds up the scrolling; pressing the opposite one slows it down.  Any
  2832.    other key stops auto-scroll.
  2833.  
  2834.    ---------------------------------------------------------------------------
  2835.    * NOTE: Pressing [Home] twice in a row is the same as pressing [^Home], and
  2836.    pressing [End], [End] is the same as pressing [^End].
  2837.  
  2838.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 8-5
  2839.  
  2840.  
  2841.  
  2842.    8.2.3 ASCII Format Commands
  2843.  
  2844.    a.  TAB Expansion - [#] / [Alt+#]
  2845.  
  2846.    TABs expand to 8-character boundaries as a default.  To change the TAB
  2847.    expansion, press [#], then [0], [1],...,[8].  TABs will then expand to the
  2848.    boundary you have selected.  If you choose [0], TAB characters will be
  2849.    shown as "blobs" on the screen, and no expansion will be done.
  2850.  
  2851.    The default setting is used with each new entry to LOOK.  You can change
  2852.    the default setting by pressing [Alt+#], and then [0],...,[8].  (Actually,
  2853.    [Alt+3] works too, but "#" seems more suggestive of the function.)
  2854.  
  2855.    The current TAB expansion factor is shown at the bottom of the screen.  If
  2856.    this is also the default, it will be indicated by an "=" (e.g., "tab=8");
  2857.    if it is a temporary setting, a ":" will be used (e.g., "tab:4").
  2858.  
  2859.  
  2860.    b.  Bit Stripping - [b] / [Alt+b]
  2861.  
  2862.    With files that have lots of high-order bits set (e.g., WordStar) to
  2863.    obscure the real meanings of the characters, try bit-stripping.  Pressing
  2864.    [b] causes EDDY to clear the high-order bit before the characters are
  2865.    displayed.  Press [b] again to toggle the bit-stripping action.
  2866.  
  2867.    Bit-stripping is normally OFF when you enter LOOK mode, and "bits=8" will
  2868.    be shown on the bottom line.  The "=" means the displayed value is the
  2869.    default, which will be reset at each entry to LOOK.  If you press [b], you
  2870.    will see the display "bits:7".  This means that only the low-order 7 bits
  2871.    are used from each byte for building the display, and the ":" indicates
  2872.    that this is a temporary state, in effect only until you exit LOOK mode.
  2873.  
  2874.    To change the default state for bit-stripping, press [Alt+b].
  2875.  
  2876.    If you use [b] (or [Alt+b]) after the first line of the file, EDDY loses
  2877.    track of the line number.  To indicate this, the bottom line shows
  2878.    "line:?".  Returning to the top of the file restores the line number
  2879.    synchronization.
  2880.  
  2881.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 8-6
  2882.  
  2883.  
  2884.  
  2885.    c.  Ruler Line Display - [r] / [u] / [d]
  2886.  
  2887.    To determine what position a particular character in the display occupies
  2888.    in its line, press [r].  You will see a line similar to this one:
  2889.  
  2890.    21 ++++++^+++++++++^+++++++++^+++++++++^+++++++++^+++++++++^+++++++++^+++++
  2891.  
  2892.    The number at the left is the column number in the file of the character
  2893.    shown in column 1 of the screen.  The "^" characters mark the columns which
  2894.    are even multiples of 10 in the FILE (not necessarily the same as columns
  2895.    on the screen).  In this example, which is what you might see after a
  2896.    [right bracket], the "^"s mark columns 30, 40, etc.
  2897.  
  2898.    The ruler is moved up or down by pressing [u] or [d], respectively.
  2899.  
  2900.  
  2901.    d.  Jump to New Line - [j]
  2902.  
  2903.    To move directly to any line in the file, press [j], type the line number
  2904.    you are interested in, and press [Enter].  The requested line will be at
  2905.    the top of the screen.  If you type a number larger than any in the file,
  2906.    you'll get a display of the last few lines.
  2907.  
  2908.    After pressing [j], you'll see a field of 6 zeros, for entering the line
  2909.    number to which you want to jump.  The cursor starts in the third digit of
  2910.    this field, on the assumption that line numbers entered will most
  2911.    frequently be 9999 or less.  However, you may use all 6 positions if
  2912.    needed.  Line numbers up to 999,999 are supported.
  2913.  
  2914.  
  2915.    e.  Line Wrapping - [l] / [Alt+l]
  2916.  
  2917.    Line wrapping means all lines are "broken" if they are longer than 80
  2918.    characters, with the remainder appearing on the next line of the screen.
  2919.    Thus, the whole line is visible on the screen at once.
  2920.  
  2921.    [l] is a toggle key which turns line wrapping alternately ON and OFF.  Line
  2922.    wrapping normally defaults to OFF on entering LOOK mode.  In this case, you
  2923.    would see the string "line=1" at the bottom of the display, which tells you
  2924.    that line wrapping is OFF (the first character is "l"), this is the default
  2925.    state for the toggle (the "=" sign) and we are at the first line of the
  2926.    file.  If you press [l] to turn line wrapping ON, a broken vertical line
  2927.    (the DOS "piping" symbol) replaces the "l" in "line", and the string
  2928.    displayed would be "|ine:1".  The ":" shows that ON is a temporary state.
  2929.  
  2930.    To change the default state for line-wrapping, press [Alt+l].
  2931.  
  2932.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 8-7
  2933.  
  2934.  
  2935.  
  2936.    Even though the lines are wrapped on the screen, EDDY still works with
  2937.    complete logical lines, as determined by the presence of CR/LF characters.
  2938.    When you move the display up or down, a line at a time or by paging, the
  2939.    display moves in units of complete logical lines.  The display will always
  2940.    begin at the start of a logical line (except in some cases when toggling
  2941.    between ASCII and hex formats).  Movement of the display up or down is
  2942.    based on the line at the top of the screen.
  2943.  
  2944.  
  2945.    8.2.4 Hex Format Display
  2946.  
  2947.    An example of a hex format display appears below (Figure 8-2).  The number
  2948.    under the heading "Offset" is the number of bytes from the start of the
  2949.    file, in hex.  Next comes the hex value of the data, followed by the
  2950.    equivalent characters, under the "ASCII" heading.
  2951.  
  2952. ================================================================================
  2953.  Offset    00 01 02 03 04 05 06 07-08 09 0A 0B 0C 0D 0E 0F          ASCII     P
  2954.  
  2955. 00000000   E9 ED 0E F5 01 9B 06 B3 A4 23 2A 38 6C 38 0B 1B     im.u...3$#*8l8..
  2956. 00000010   1E 1E 43 59 43 43 4E 00 00 00 00 00 00 00 46 09     ..CYCCN.......F.
  2957. 00000020   00 00 41 42 43 44 45 46 49 4B 4D 50 52 54 57 03     ..ABCDEFIKMPRTW.
  2958. 00000030   4E 06 00 00 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F     N...????????????
  2959. 00000040   3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F     ????????????????
  2960. 00000050   3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F     ????????????????
  2961. 00000060   3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F 3F     ????????????????
  2962. 00000070   3F 3F 3F 3F D5 CD CD CD CD CD CD CD CD CD CD CD     ????UMMMMMMMMMMM
  2963. 00000080   CD CD CD CD CD CD CD CD CD CD CD CD CD CD CD CD     MMMMMMMMMMMMMMMM
  2964. 00000090   CD CD B8 0A 24 B3 20 54 48 41 4E 4B 20 59 4F 55     MM8.$3 THANK YOU
  2965. 000000A0   20 66 6F 72 20 75 73 69 6E 67 20 45 44 44 59 28      for using EDDY(
  2966. 000000B0   74 6D 29 B3 0A 24 B3 20 20 20 20 20 20 20 20 20     tm)3.$3
  2967. 000000C0   76 65 72 73 69 6F 6E 20 35 2E 30 31 20 20 20 20     version 5.01
  2968. 000000D0   20 20 20 20 B3 0A 24 B3 20 20 20 43 6F 70 79 72         3.$3   Copyr
  2969. 000000E0   69 67 68 74 28 43 29 20 31 39 38 37 2C 38 38 2C     ight(C) 1987,88,
  2970. 000000F0   38 39 20 20 20 B3 0A 24 B3 20 62 79 20 4A 6F 68     89   3.$3 by Joh
  2971. 00000100   6E 20 53 63 6F 66 69 65 6C 64 2C 20 42 6F 78 20     n Scofield, Box
  2972. 00000110   34 37 31 33 36 20 B3 0A 24 B3 4D 6F 72 72 69 73     47136 3.$3Morris
  2973. 00000120   6F 6E 20 48 69 6C 6C 20 50 2E 4F 2E 2C 20 48 6F     on Hill P.O., Ho
  2974. 00000130   6E 67 20 4B 6F 6E 67 B3 0A 24 B3 20 20 20 20 20     ng Kong3.$3
  2975. 00000140   41 6C 6C 20 72 69 67 68 74 73 20 72 65 73 65 72     All rights reser
  2976.  
  2977. -LOOK-   EDDY.COM      bits=8  tab=8  line=1      [F1]:HELP  [Alt+F1]/click:MENU
  2978. ================================================================================
  2979.  
  2980.                                 Figure 8-2
  2981.  
  2982.    NOTE: If no mouse is present, there will be no reference to click on the
  2983.    bottom line.  See Section 3.1.2 for information on using EDDY with a mouse.
  2984.  
  2985.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 8-8
  2986.  
  2987.  
  2988.  
  2989.    8.2.5 Hex Format Commands
  2990.  
  2991.    The keys used in LOOK mode to move around in the hex-format display are:
  2992.  
  2993.     [Up]    - move up 1 line          [PgUp]  - up 1 page
  2994.     [Down]  - move down 1 line        [PgDn]  - down 1 page
  2995.     [^Home] - display first page      [^End]  - display last page
  2996.     [^PgDn] - auto-scroll down        [^PgUp] - auto-scroll up
  2997.  
  2998.    Additional commands available in hex format are described below, and in
  2999.    Section 8.6, "Mark Data".
  3000.  
  3001.  
  3002.    a.  Printability - [p]
  3003.  
  3004.    Normally, the bytes displayed under the "ASCII" heading are the exact
  3005.    equivalents of the hex data.  However, many of the characters corresponding
  3006.    to the hex values in the ranges 00h -- 1Fh and 7Fh -- 9Fh are interpreted
  3007.    as printer commands by most printers.  An attempt to use the DOS
  3008.    [Shift]-[PrtSc] function on a screen containing these characters will
  3009.    result in an assortment of form feeds, font changes, carriage returns,
  3010.    etc., rather than the screen print desired.
  3011.  
  3012.    EDDY provides an option to accommodate screen printing of hex displays.  If
  3013.    you press [p], telling EDDY to format the screen for printing, the
  3014.    characters in the troublesome ranges will be replaced by periods, and all
  3015.    high-order bits will be turned off.  The hex data part of the display is
  3016.    unchanged.  When [p] is pressed, a blinking letter "P" appears at the right
  3017.    end of line 1 to remind you that "printability" is turned on.  [p] is a
  3018.    toggle key, and turns printability alternately on and off.
  3019.  
  3020.    The example in Figure 8-2 has printability selected.
  3021.  
  3022.  
  3023.    b.  Bit Stripping - [b] / [Alt+b]
  3024.  
  3025.    Bit stripping in hex format works as described in 8.2.3b, above, but
  3026.    affects only the ASCII portion of the display.  The actual character
  3027.    present in the file, with no bits stripped, is shown in the hex portion of
  3028.    the display.
  3029.  
  3030.  
  3031.    c.  Jump to New File Position - [j]
  3032.  
  3033.    To move directly to any position in the file, press [j] and then type the
  3034.    8-digit hex offset which you are interested in.  If you type too large a
  3035.    value, you'll get a display of the last few lines of the file.
  3036.  
  3037.    If you jump with the display in hex format, EDDY loses track of the line
  3038.    number (but you get there faster).
  3039.  
  3040.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 8-9
  3041.  
  3042.  
  3043.  
  3044.    d.  Word-oriented Display - [w], [W]
  3045.  
  3046.    When LOOKing at a file in hex format, you may select the hex portion of the
  3047.    display to be in words (as opposed to the normal bytes) by pressing [w].
  3048.    If you want to see the words in inverted order (high-order byte first),
  3049.    press [W].  Press the same key again to return to the normal byte display.
  3050.  
  3051.    If you want the word display to start with the odd-numbered bytes, press
  3052.    [t].  Press [t] again to revert to even byte orientation.
  3053.  
  3054.    When displaying inverted words, the heading at the top of the display shows
  3055.    the inverted sequence of bytes.
  3056.  
  3057.  
  3058.    8.2.6 LOOK Mode With a Mouse
  3059.  
  3060.    In LOOK mode, ASCII (text) display format, a left click from anywhere
  3061.    displays the menu.
  3062.  
  3063.    When PATCHing, a left click anywhere except the indicated "click area"
  3064.    (directly above the "up" arrows on the bottom line) means "update" (same as
  3065.    [Enter]).  A click within the click area displays the menu.
  3066.  
  3067.    A right click returns to EDIT from LOOK, or to LOOK from PATCH.
  3068.  
  3069.  
  3070.    8.3 LOOK at File Contents (in Target Directory) - [Alt+F3]
  3071.  
  3072.    To LOOK at the contents of a file in the target directory which has the
  3073.    same name as the current file, press [Alt+F3].  Remember, if the current
  3074.    file has been renamed, even though not yet UPDATEd, the NEW name will be
  3075.    used to decide which target file to LOOK at.  If there is no target
  3076.    directory, or there is no file with that name, you will be informed.
  3077.    Otherwise, you will see a display identical to that described above, and
  3078.    all the LOOK mode commands will work the same way.
  3079.  
  3080.    When the file displayed is from the target directory, a "T" is shown on the
  3081.    last line in column 7, thus:
  3082.  
  3083. ================================================================================
  3084. . . .
  3085. 00000100   24 B3 20 20 20 43 6F 70 79 72 69 67 68 74 20 28     $    Copyright (
  3086. 00000110   43 29 20 31 39 38 37 2C 31 39 38 38 20 20 20 B3     C) 1987,1988   |
  3087. 00000120   24 B3 20 62 79 20 4A 6F 68 6E 20 53 63 6F 66 69     $| by John Scofi
  3088. 00000130   65 6C 64 2C 20 42 6F 78 20 34 37 31 33 36 20 B3     eld, Box 47136 |
  3089. 00000140   24 B3 4D 6F 72 72 69 73 6F 6E 20 48 69 6C 6C 20     $|Morrison Hill
  3090.  
  3091. -LOOK-T  EDDY.COM      bits=8  tab=8  line=1       [F1]:HELP       [Alt+F1]:MENU
  3092. ================================================================================
  3093.  
  3094.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 8-10
  3095.  
  3096.  
  3097.  
  3098.    8.4 LOOK at RAM (or ROM, or ???)
  3099.  
  3100.    To LOOK at your PC's memory (if option /R is ON) move to the " memory"
  3101.    entry and press [F3].  RAM contents will be displayed in hex format, from
  3102.    0000:0000 up to the limit of installed RAM.  EDDY bases its assumption
  3103.    about RAM size on the value in memory at 0040:0013 - 0040:0014h at the time
  3104.    EDDY begins executing.  If your system has 640K, for example, you will see
  3105.    "80 02" in these locations.
  3106.  
  3107.    EDDY refreshes the display between keystrokes, so you can watch various
  3108.    locations in RAM as they change; e.g., the BIOS timer count at 0040:006Ch,
  3109.    the diskette motor counter at 0040:0040h, or the keyboard buffer and
  3110.    related data starting at 0040:0017h.  (Not true for Color Graphics Adapters
  3111.    -- too much screen "flicker".  See the description of the "snow OK"
  3112.    configuration parameter in Section 30.3.2b if you have a CGA).
  3113.  
  3114.    It's sometimes interesting to look at other parts of the PC address space,
  3115.    such as ROMs and display memory.  For example, if you press [j] and then
  3116.    enter an offset of "F000:FFFF", you will see the end of the BIOS ROM, which
  3117.    usually has the copyright notice.
  3118.  
  3119.    One curiosity:  When accessing addresses that have no physical memory
  3120.    equivalent, EDDY will usually show hex "FF" for those bytes; however, bytes
  3121.    with other values sometimes appear.  If you try to go back to display those
  3122.    bytes after they have scrolled off the screen, they may have changed value
  3123.    or even have disappeared.  I can't explain why this happens, but it doesn't
  3124.    appear to be a bug in EDDY.  This also occurs with DEBUG and Turbo Debugger
  3125.    when they are used to look at high memory.
  3126.  
  3127.  
  3128.    8.5 LOOK at Entire Disk
  3129.  
  3130.    LOOKing at an entire physical disk, regardless of file locations or
  3131.    extents, is explained in detail in Section 24.2.
  3132.  
  3133.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 8-11
  3134.  
  3135.  
  3136.  
  3137.    8.6 Mark Data - [m]
  3138.  
  3139.    "Marking data" means to select a range of bytes, from within a file, any
  3140.    address in RAM, or anywhere on a disk, to be highlighted in the LOOK mode
  3141.    (hex format) display.
  3142.  
  3143.    The information in this section applies to ANY data being LOOKed at.  When
  3144.    LOOKing at raw disk image data, there are additional capabilities, which
  3145.    are described in Section 25.3.
  3146.  
  3147.    When you have marked data...
  3148.  
  3149.    ... You can use the marks as a "place holder", allowing you to move the
  3150.    display to view other areas and return to viewing the marked area easily
  3151.  
  3152.    ... You can copy the marked bytes to a file (e.g., extract bytes from one
  3153.    file into another, or copy a loaded program from its RAM image to a file)
  3154.  
  3155.    ... You can use the highlighting as an aid for examining areas of interest
  3156.    (such as the RAM BIOS area, where some bytes are counters that are
  3157.    continually updated by the BIOS, as described in Section 8.4)
  3158.  
  3159.    There are three types of marks:
  3160.  
  3161.    1.  "Byte" marks select a continuous range of bytes to be highlighted.
  3162. |      This is the normal style of mark.  If EDDY doesn't ask you to choose a
  3163. |      style of mark -- as will be the case when you're LOOKing at a file --
  3164. |      byte marking is the style used.
  3165.  
  3166.    2.  "Disk" marks are used only when LOOKing at raw disk image data, and are
  3167.        used to select full disk sectors or clusters.  Disk marks are discussed
  3168.        in detail in Section 25.3.
  3169.  
  3170. |  3.  "Column" marks are used only when LOOKing at RAM.  They select a
  3171. |      rectangular column, or "box" of bytes, defined by the diagonally-
  3172. |      opposite corners of the box (i.e., upper left/lower right or vice
  3173. |      versa).
  3174.  
  3175.    To mark data, press [m] while displaying the data you want to mark.  EDDY
  3176.    will ask which type of mark you want to use.  Cursors will then be
  3177.    displayed (just as in PATCH mode), to let you choose the byte to be marked,
  3178.    by pressing [Enter].  That byte will then be highlighted in the display.
  3179.  
  3180.    If you press [m] again, you may mark another byte, and those two marked
  3181.    bytes together define the range of bytes to be highlighted.
  3182.  
  3183.    To modify the marked range, press [m] again.  If the new marked byte is
  3184.    outside the currently marked area, the range will be extended to include
  3185.    it (and all bytes in between).  If the new byte is within the currently
  3186.  
  3187.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 8-12
  3188.  
  3189.  
  3190.  
  3191.    marked area, you will be asked whether it is the start or end of the range
  3192.    that you want to adjust, and the range will be shortened accordingly.
  3193.  
  3194.    Pressing [F2] undoes all marks.
  3195.  
  3196.  
  3197.    8.6.1  Jump to Marked Area - [Alt+m]
  3198.  
  3199.    If you press [Alt+m], the display will show the first marked byte, if any,
  3200.    at the top of the screen, unless it is ALREADY at the top of the screen.
  3201.    In the latter case, if there are more marked bytes, the display will move
  3202.    to the last one.
  3203.  
  3204.    [Alt+m] has no effect if there are no marked areas.
  3205.  
  3206.  
  3207.    8.6.2  COPY Marked Area - [F5]
  3208.  
  3209.    When you have marked the range of bytes you want to copy, press [F5].  If
  3210.    there is no target directory, you will be asked to specify one.
  3211.  
  3212.    EDDY provides default filenames in the target directory to use for copying
  3213.    marked data.  You may specify other filenames if you wish.  If the filename
  3214.    to be used already exists in the target, you will be asked whether you want
  3215.    to overwrite the existing file or append the new data to it.  Appending
  3216.    offers the capability of collecting more than one set of marked data in a
  3217.    single file (by marking, then copying, then repeating those steps).
  3218.  
  3219. |  While the copy is in progress, you may cancel it by pressing [^c].  If you
  3220. |  do this, any data written up to that point will be in the target file.
  3221.  
  3222.  
  3223.    8.6.3 COPY Unmarked Area - [Alt+F5]
  3224.  
  3225.    [Alt+F5] works identically to [F5], except everything BUT the marked bytes
  3226.    is copied.
  3227.  
  3228. |  While the copy is in progress, you may cancel it by pressing [^c].  If you
  3229. |  do this, any data written up to that point will be in the target file.
  3230.  
  3231.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 8-13
  3232.  
  3233.  
  3234.  
  3235.    8.7 Compare Directory Entries - [Shift+F3], [Shift+^F3]
  3236.  
  3237.    To compare the directory entries of corresponding files in the working and
  3238.    target directories, press [Shift+F3].  If files have been renamed, even
  3239.    though not yet UPDATEd, the NEW name will be used for comparisons.
  3240.  
  3241.    Press [Ctrl], [Shift] and [F3] simultaneously to compare working and target
  3242.    directory entries (one at a time) of all files in the working directory.
  3243.    After each comparison, the result is displayed and EDDY waits for a key to
  3244.    be pressed before proceeding to the next comparison.
  3245.  
  3246.    [^c] or [BackSpace] terminates a [Shift+^F3].
  3247.  
  3248.    If you use EDDY's "snapshot" feature (see Section 23), there is another to
  3249.    compare directories.  You can compare a directory with the way it was at
  3250.    some earlier time, or you can get a complete report on differences between
  3251.    directories (as opposed to viewing the differences one-by-one as described
  3252.    above).  To do this type of comparison:
  3253.        1.  Take a "snapshot" of the working directory
  3254.        2.  Copy the snapshot to the target directory
  3255.        3.  Press [Alt+x] to exchange working/target directories
  3256.        4.  Move to the top line of the display ("DIR of..." entry)
  3257.        5.  Press [Shift+F3]
  3258.        6.  Answer [y] to the message warning that the snapshot is
  3259.            for a different directory
  3260.        7.  EDDY will produce a summary of differences, and a detailed
  3261.            list of those differences, by category, file-by-file
  3262.  
  3263.  
  3264.    8.8 Compare Files - [Alt+Shift+F3]
  3265.  
  3266.    Press [Alt], [Shift] and [F3] simultaneously to compare the contents of the
  3267.    current file and the corresponding file (i.e., same filename) in the target
  3268.    directory.  If files have been renamed, even though not yet UPDATEd, the
  3269.    NEW name will be used for comparisons.
  3270.  
  3271.    EDDY will tell you whether the file contents are identical or not.  The
  3272.    offset in the file where bytes do not match (if any) will be displayed,
  3273.    along with the hex values of the bytes involved.
  3274.  
  3275.    If the files are different lengths, the comparison will still be done.
  3276.    This allows you to determine, for example, whether the files are identical
  3277.    at least up to the length of the shorter one.
  3278.  
  3279.    Successive [Alt+Shift+F3]'s on the same file tell you the next byte where a
  3280.    difference exists.  If there are no more differences, EDDY will tell you
  3281.    that.  (On files of different lengths, if the only difference is the extra
  3282.    bytes in the longer one, only the first difference will be reported.)
  3283.  
  3284.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 9-1
  3285.  
  3286.  
  3287.  
  3288.    9.  PATCH Command - [F4], [^F4]
  3289.  
  3290.    Normally, you will use LOOK or FIND before PATCH, in order to locate the
  3291.    place in the file to PATCH.  Once you have found it, press [F4].  If you
  3292.    want to PATCH every file in the directory (one at a time), press [^F4].
  3293.  
  3294.    Pressing [Esc], or pressing [F4] a second time, returns you to LOOK mode.
  3295.  
  3296.    The PATCH mode display is similar to the LOOK mode hex format display with
  3297.    "printability" turned off.  It has two cursors -- one in the hex part of
  3298.    the display and one in the ASCII part.  These cursors move in unison, to
  3299.    facilitate matching corresponding bytes in the two parts of the display.
  3300.  
  3301.    One of the cursors will be blinking, the other not.  The blinking cursor
  3302.    shows where you may enter changes to the data.  [Tab] toggles between hex
  3303.    and ASCII data entry formats.  (If you don't like [Tab] for this purpose,
  3304.    see Section 8.2.1a).  If [Tab] is not the toggle key, it can be used to
  3305.    enter TAB -- 09h -- bytes directly in ASCII format).
  3306.  
  3307.    In ASCII data entry format, the cursor in the text part of the display
  3308.    blinks and the hex cursor does not.  The hex cursor also expands to cover
  3309.    two hex digits, since entering a single text character affects both digits.
  3310.  
  3311.    In either format, as you enter data in one part of the display the
  3312.    corresponding data in the other part is updated and displayed accordingly.
  3313.    Also, any data changed remains highlighted (reverse video) in the display.
  3314.  
  3315.    You can move the cursors to the place you want to change data with the
  3316.    "arrow" keys -- [Left], [Right], [Up] and [Down] -- and [Home] and [End].
  3317.  
  3318.    If you go to PATCH right after a FIND, the blinking cursor will be on the
  3319.    character at the start of the "found" string.  The cursor will be in the
  3320.    same mode (hex/ASCII) used to enter the search string when you did the
  3321.    FIND.  If you press any key except [F4] after the FIND, the cursor will be
  3322.    placed on the first character of the display if you then PATCH.
  3323.  
  3324.    Changes can be made to only one screen at a time.  To UNDO, press [F2].
  3325.  
  3326.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 9-2
  3327.  
  3328.  
  3329.  
  3330.    9.1 Changing a File's Length
  3331.  
  3332.    Press [Alt+z] to add bytes at the end of a file, or [Alt+y] to delete
  3333.    bytes, either from the beginning or end of the file.
  3334.  
  3335.  
  3336.    9.1.1 Appending Bytes to a File - [Alt+z]
  3337.  
  3338.    Files may also be expanded using PATCH.  With the cursor at the end of the
  3339.    file, if there is unused space left on the screen, you can add a "^Z" (end-
  3340.    of-file byte) after the last byte in the file by pressing [Alt+z].  You can
  3341.    add as many bytes as you want, up to the limit of space on the screen (or
  3342.    until the disk is full).  Bytes that have been added can also be patched.
  3343.  
  3344.  
  3345.    9.1.2 Deleting Bytes From a File - [Alt+y]/[Alt+a]/[Alt+b]
  3346.  
  3347.    After a press of [Alt+y], EDDY asks whether you want to delete bytes BEFORE
  3348.    or AFTER the cursor, and then waits for [b] or [a], respectively.  Press
  3349.    [Esc], if you decide not to delete anything after all.
  3350.  
  3351.    Pressing [b] deletes from the beginning of the file up to the byte at the
  3352.    cursor.  [a] deletes everything in the file after the byte at the cursor.
  3353.    The byte at the cursor is never deleted.  If you press [b] with the cursor
  3354.    on the first byte of the file, or [a] while it's on the last, EDDY won't
  3355.    complain, but nothing will be deleted.
  3356.  
  3357.    Pressing [Alt+a] is equivalent to [Alt+y] followed by [a], with no question
  3358.    asked.  [Alt+b] is equivalent to [Alt+y], then [b].
  3359.  
  3360.    Note that deleting bytes from the beginning of a large file generally takes
  3361.    a LOT more time than deleting from the end.  This is because in the first
  3362.    case all of the data following the bytes to be deleted must be rewritten,
  3363.    while in the latter it's a simple truncate operation.
  3364.  
  3365.  
  3366.    9.2 Updating in PATCH - [Enter] or [^Enter]
  3367.  
  3368.    Write your changes to disk by pressing [Enter] twice.  Normally -- after
  3369.    [Enter] -- EDDY puts the current DOS date and time on a file that has been
  3370.    patched.  If you use [^Enter] to start the UPDATE, EDDY asks whether you
  3371.    want to do this.
  3372.  
  3373.    After UPDATE, EDDY will return to LOOK mode.  In LOOK mode you may move to
  3374.    another part of the file, and then press [F4] to go back to PATCH to make
  3375.    more changes.  Repeat the PATCH-UPDATE-LOOK-PATCH cycle as needed.
  3376.  
  3377.  
  3378.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield    page 9-3
  3379.  
  3380.  
  3381.  
  3382.    9.3 PATCHing RAM
  3383.  
  3384.    With option /R turned ON, you may change your PC's memory by using PATCH on
  3385.    the " memory" entry in the display.
  3386.  
  3387.    One thing that is almost SURE to hang up your machine is to mess with the
  3388.    values in the BIOS keyboard buffer pointers (0040:001A - 0040:001D), so
  3389.    EDDY will not allow these locations to be updated.  EDDY won't complain if
  3390.    you TRY to change them, and they'll appear to be changed right after
  3391.    patching, but they'll really still be set to the values DOS has put there.
  3392.  
  3393.  
  3394.    9.4 PATCHing Disks by Physical Sector
  3395.  
  3396.    You may PATCH any bytes on a physical disk, regardless of file locations or
  3397.    extents.  This is explained in detail in Section 24.5.
  3398.  
  3399.    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  3400.    WARNING!  USE GREAT CARE WITH SECTOR PATCHING ON "COMPRESSED" OR "EXTENDED"
  3401.    DRIVES -- I.E., DEVICES CREATED AND MANAGED BY DOUBLESPACE, STACKER, AND
  3402.    SIMILAR PRODUCTS.  PATCHING FILES STORED ON THOSE DISKS IS PERFECTLY SAFE,
  3403.    HOWEVER.  SEE SECTION 24.1 FOR MORE INFORMATION.
  3404.    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  3405.  
  3406.  
  3407.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 10-1
  3408.  
  3409.  
  3410.  
  3411.    10. Synchronization Controls - [Alt+c]
  3412.  
  3413.    These Controls affect operation of the COPY, MOVE, DELETE and DESTROY
  3414.    commands, which are described in Sections 11 through 13.
  3415.  
  3416.    When copying, moving or deleting files, you'll often want to choose the
  3417.    files to be operated on based upon whether they are in the target directory
  3418.    or not, and also based on a comparison of their timestamps.  Common cases
  3419.    are when you'd like to give commands such as:
  3420.  
  3421.       "Copy files that are newer than the corresponding files in the target"
  3422.    or
  3423.       "Delete files that are duplicates of those in the target".
  3424.  
  3425.    The Synchronization Controls allow you to just that, as well as many other
  3426.    combinations.
  3427.  
  3428.  
  3429.    10.1  Controls for COPY/MOVE
  3430.  
  3431.    There is a Control for each of the following cases:
  3432.  
  3433.        1. File not in target
  3434.        2. Target file older
  3435.        3. Target file NEWER!
  3436.        4. Target different size (date and time same)
  3437.        5. Same date,time & size
  3438.  
  3439.    The Controls are always checked when a COPY or MOVE command is used.
  3440.  
  3441.    These Controls (1-5) may each have a setting of:
  3442.        "Y" - Yes, tag the file if this statement is true,
  3443.        "N" - No, don't tag the file if this statement is true, or
  3444.        "C" - Confirm before tagging (i.e., ask before tagging)
  3445.  
  3446.    Controls set to "Y" or "N" only affect the operation of the multiple-file
  3447.    COPY and MOVE commands -- [^F5] and [^F6].  They are NOT used with and have
  3448.    NO EFFECT on single-file commands -- e.g., COPY this file ([F5]).
  3449.  
  3450.    Controls set to "C" affect both single- and multiple-file COPY and MOVE
  3451.    command -- [F5], [^F5], [F6], [^F6].  A Control setting of "C" means
  3452.    whenever that case is encountered, the target directory entry will be
  3453.    displayed.  EDDY then waits for you to confirm whether you want to tag the
  3454.    file or not.  This is explained further in Section 10.2. ("C" works
  3455.    slightly differently in batch mode; see Section 29.3 for more information).
  3456.  
  3457.    Thus, for the example...
  3458.  
  3459.       "Copy files that are newer than the corresponding files in the target"
  3460.  
  3461.    the corresponding Control settings would be N,Y,C,C,N.
  3462.  
  3463.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 10-2
  3464.  
  3465.  
  3466.  
  3467.    With these settings (N,Y,C,C,N), tagging will be done as follows:
  3468.  
  3469.        1. Any files not in the target won't be tagged.
  3470.        2. Any files newer than files with the same name will be tagged.
  3471.        3. If there is a file in the target that is newer than the one in the
  3472.             working directory, the two files' directory entries will be dis-
  3473.             played and EDDY will wait for you to decide whether to tag or not.
  3474.        4. If the files in the working and target directories have the same
  3475.             timestamps, but the files' sizes are different, EDDY will display
  3476.             and wait, as with #3.
  3477.        5. Any files with identical timestamps and sizes won't be tagged.
  3478.  
  3479.    The default Control settings (1 - 5) are Y,Y,C,C,N.  The settings may be
  3480.    displayed and/or changed by pressing [Alt+c].  Select the values for the
  3481.    Controls by pressing [y], [n], or [c], or by pressing [SpaceBar].  Pressing
  3482.    [*] restores default settings.
  3483.  
  3484.    There is one case where the "File not in target" control will be ignored.
  3485.    If you COPY or MOVE when there is no target directory, you may create a new
  3486.    directory to serve as the target (see Section 5.2.2).  If you have just
  3487.    created the target, then obviously any file you want to copy will be "not
  3488.    in target".  In this case, Control #1 will be treated as "Y" as long as the
  3489.    target directory remains the same.
  3490.  
  3491.    In addition to the cases defined by the Controls, some other situations are
  3492.    also require confirmation:
  3493.  
  3494.    - A COPY or MOVE must be confirmed if the corresponding file in the target
  3495.        has the "read-only" attribute ON.
  3496.    - A MOVE, DELETE or DESTROY must be confirmed if the file has the "read-
  3497.        only" attribute ON.
  3498.  
  3499.  
  3500.    10.2 Tagging Confirmation Process
  3501.  
  3502.    During any (single- or multiple-file) COPY or MOVE, if EDDY encounters a
  3503.    case where the working and target files meet the condition defined by a
  3504.    Control which is set to "C", the directory entries and the following
  3505.    message is displayed:
  3506.  
  3507.       "[F3]/[Alt+F3]:LOOK,  [F5]:COPY,  [F6]:MOVE,  [F7]:DELETE,  else [Esc]"
  3508.  
  3509.    [F3] goes into LOOK mode, to examine the file contents in the working
  3510.    directory, in case you need more information from the file in order to
  3511.    decide what to do.  [Alt+F3] LOOKs at the file contents in the target.  In
  3512.    either case, when you exit from LOOK, you will be at the same place in the
  3513.    display, with EDDY still waiting for one of the other keys to be pressed.
  3514.  
  3515.    [F5], [F6] and [F7] will tag the file for the normal action for that key.
  3516. |  [Esc] -- or any other key except [Alt+c] -- will leave the file untagged.
  3517.  
  3518.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 10-3
  3519.  
  3520.  
  3521.  
  3522. |  In addition to the keys suggested in the confirmation display, you may
  3523. |  press [Alt+c], which will again display the Synchronization Controls
  3524. |  window, allowing you to change the settings at any point during a multiple-
  3525. |  file operation.
  3526.  
  3527.    One situation can be tricky:  if the confirmation display is because of
  3528.    "Target file NEWER!", and you proceed to LOOK mode -- [F3] -- and from
  3529.    there to PATCH -- [F4] -- your patching will (unless you use [^Enter]
  3530.    rather than [Enter] to apply the patch) update the file's timestamp.  Upon
  3531.    return, EDDY will find that the condition requiring your decision no longer
  3532.    exists (i.e., the timestamp is NOW), and will therefore automatically tag
  3533.    the file for COPY or MOVE.
  3534.  
  3535.  
  3536.    10.3 Synchronizing/Reconciling Directories
  3537.  
  3538.    Often it is useful to be able to ensure that two directories have exactly
  3539.    the same versions of the same files.  If you are just interested in knowing
  3540.    what the differences are, if any, refer to Section 8.7.  If you actually
  3541.    want to make the directories identical (this is particularly handy when you
  3542.    are working with more than one computer and using a floppy to carry data
  3543.    back and forth), here's how:
  3544.  
  3545.    With the Synchronization Controls set to their default values (Y,Y,C,C,N),
  3546.    proceed as follows:
  3547.  
  3548.        1. Set one of the directories to be synchronized as working and the
  3549.             other as target (it doesn't matter which is which).
  3550.        2. Press [^F5] to tag all files that need to be copied.
  3551.        3. Press [Enter] twice to start the copying (UPDATE) process.
  3552.        4. Wait for "UPDATE Complete" message.
  3553.        5. Press [Alt+x] to exchange the working and target directories.
  3554.        6. Repeat Steps b, c and d.
  3555.  
  3556.    Synchronization of the directories is now complete.  The only way there
  3557.    could be any difference between them is if copies of a file existed
  3558.    originally in both directories, and had the same timestamp and size, but
  3559.    the files' contents were different.
  3560.  
  3561.  
  3562.    10.4 Controls for DELETE/DESTROY
  3563.  
  3564.    There is also a sixth Synchronization Control, which determines whether the
  3565.    first 5 will be used to control the DELETE and DESTROY commands, too:
  3566.  
  3567.        6. CONTROLS for Delete?
  3568.  
  3569.    This Control may be set to either "Y" or "N" -- "C" is not applicable.
  3570.  
  3571.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 10-4
  3572.  
  3573.  
  3574.  
  3575.    When Control 6 is set to "Y", the files in the target will be checked as
  3576.    specified by the settings of Controls 1 - 5, and the tagging will be done
  3577.    accordingly.  If there is no target directory, Control #6 has no effect.
  3578.  
  3579.    Thus, for the example...
  3580.             "Delete files that are duplicates of those in the target"
  3581.    the Control settings (1 - 6) would be N,N,N,N,Y,Y (or N,C,C,C,Y,Y if you
  3582.    want EDDY to tell you about any differences).
  3583.  
  3584.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 11-1
  3585.  
  3586.  
  3587.  
  3588.    11.  COPY Command - [F5], [^F5]
  3589.  
  3590.    You may copy files and/or directories (and all their contents).  The
  3591.    Synchronization Controls (see Section 10) work closely with the COPY
  3592.    command to help you in deciding which files you want to copy.
  3593.  
  3594.    When copying, EDDY has the capability of changing the new copy's data in
  3595.    certain ways -- "converting" the file.  The available CONVERT functions are
  3596.    described in Section 11.5.
  3597.  
  3598.    EDDY also allows you to copy RAM to a file (see Section 19), and to copy
  3599.    raw disk-image data -- sectors, clusters, complete disks -- to and from
  3600.    files (see Section 25).
  3601.  
  3602.    The COPY command actually just "tags" a file to indicate that it has been
  3603.    selected.  The word "Copy" (or "Copy+", if no file of the same name is
  3604.    currently in the target directory) will appear, to show the file has been
  3605.    tagged.  The actual copy will be done when you enter UPDATE mode.  After
  3606.    UPDATE, "copied" will appear in the display for that file.
  3607.  
  3608.    If you have indicated other changes to be made to the file's directory
  3609.    entry (renaming, timestamping or attribute settings), these changes will be
  3610.    made during the UPDATE process before the copying, so the target copy will
  3611.    have the same settings as the working directory file after the update.
  3612.  
  3613.    An exception to this is the archive attribute bit.  Files copied will have
  3614.    the archive attribute turned ON in the target directory (unless you are
  3615.    using option /A, or the target is on a remote disk).  For files copied from
  3616.    a fixed disk (or RAM disk) to a floppy, the archive attribute is also set
  3617.    OFF in the working directory.  In all other cases, the archive attribute is
  3618.    left unchanged in the working directory.
  3619.  
  3620.    Also, if a file with the "network-shareable" attribute is copied, the
  3621.    result in the target will not have that attribute.
  3622.  
  3623.    Copied files normally receive the same date and time as the original; if
  3624.    you want to put the current timestamp on copies, use [^Enter] to start the
  3625.    UPDATE process, rather than [Enter].  If you use [^Enter], EDDY will ask
  3626.    you whether or not you want new timestamps.  (See also the discussion of
  3627.    the "timestamp" configuration parameter, in Section 30.3.2e).
  3628.  
  3629.    Changing the target while files are tagged for copying will result in these
  3630.    files being un-tagged EDDY will warn you if this would occur.
  3631.  
  3632.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 11-2
  3633.  
  3634.  
  3635.  
  3636.    11.1 COPY a File - [F5]
  3637.  
  3638.    Press [F5] to tag the current file for copying.  If there is no target
  3639.    directory, EDDY will ask for one.  Entering target directories is explained
  3640.    in Sections 5.2.2 and 5.3.5.
  3641.  
  3642.    If the target directory contains a subdirectory that has the same name as
  3643.    the file you are trying to tag, EDDY will inform you of the conflict and no
  3644.    tagging will occur on that file.
  3645.  
  3646.  
  3647.    11.2 COPY Multiple Files - [^F5]
  3648.  
  3649.    [^F5] will review all files in the working directory for copying, except
  3650.    those already tagged for COPY, MOVE, DELETE or DESTROY (or "Ignore").  All
  3651.    files (but NOT subdirectories) which meet the criteria defined by the
  3652.    Synchronization Controls (see Section 10) will be tagged for copying.
  3653.  
  3654.    As the list of files is being reviewed, [^c] or [BackSpace] may be pressed
  3655.    to terminate the process before all files have been reviewed.  If you just
  3656.    want to pause temporarily, to look at the screen or think about what's
  3657.    going on, press and hold [ScrollLock].  All processing will stop.  Release
  3658.    the key to continue.
  3659.  
  3660.    If you want EDDY to check only those files from the cursor and further
  3661.    down, turn on option /L before pressing [^F5].
  3662.  
  3663.    Using option /5 on the command line is the batch mode equivalent of [^F5].
  3664.    See Section 29 for more information on this.
  3665.  
  3666.  
  3667.    11.3 Copying Files With Disk Errors
  3668.  
  3669.    If you have a file that's on a disk that has "bad spots", EDDY will often
  3670.    let you save the "good" parts, by COPYing the file.  See Section 28.4 for
  3671.    more information on this.
  3672.  
  3673.  
  3674.    11.4 COPY a Directory - [F5]
  3675.  
  3676.    Press [F5] to tag the current subdirectory for copying.  If there is no
  3677.    target directory, EDDY will ask for one.  Entering target directories is
  3678.    explained in Sections 5.2.2 and 5.3.3.  The target may be on a different
  3679.    drive from the working directory.
  3680.  
  3681.    If the target directory contains a file that has the same name as the sub-
  3682.    directory you are trying to tag, EDDY will inform you of the conflict and
  3683.    no tagging will occur on that subdirectory.
  3684.  
  3685.    Also, the target must not be in a path which includes the directory to be
  3686.    copied (i.e., you can't copy a directory to its own child or other
  3687.    subordinate directory).
  3688.  
  3689.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 11-3
  3690.  
  3691.  
  3692.  
  3693.    If there's a subdirectory in the target with the same name, you'll be asked
  3694.    if you wish to overwrite it.  If you do, the directory will be tagged for
  3695.    copying.  When you UPDATE, the subdirectory in the target, WITH ALL THE
  3696.    FILES AND SUBDIRECTORIES IN IT, will be deleted first and then replaced by
  3697.    the directory being copied and all ITS files and subdirectories.  There is
  3698.    no checking or comparison of file timestamps involved in this copy process;
  3699.    it is a complete replacement of one tree by another.
  3700.  
  3701. |  Copied directories will have the same timestamp as the directory they were
  3702. |  copied from.
  3703.  
  3704.    If you want to do a file-by-file update of subdirectories within a tree,
  3705.    consider using the "target tracking" feature (see Section 5.2.3).
  3706.  
  3707.  
  3708.    11.5 CONVERT File Data
  3709.  
  3710.    If you have a WordStar-like file, with lots of high-order bits obscuring
  3711.    the text, you can make a readable copy by copying with bit-stripping.  If
  3712.    you want to get rid of TAB characters in a file, you can also do that.
  3713.  
  3714.  
  3715.    11.5.1  Expand TABs - [Alt+#]
  3716.  
  3717.    To get rid of TABs in a file, tag it by pressing [Alt+#].  (Actually,
  3718.    [Alt+3] works too, but "#" seems more suggestive of the function.)  The
  3719.    file will be tagged for COPY, and EDDY will then ask you to enter a number,
  3720.    "0" thru "8", to specify the desired TAB interval.  When the COPYing is
  3721.    done, any TABs in the file will be replaced with spaces to the next n-byte
  3722.    boundary (n=0 thru 8, as you have chosen), generally resulting in a larger
  3723.    file.  This can possibly cause an out-of-space condition during the UPDATE,
  3724.    as explained in Section 28.3.  n=1 replaces each TAB by a single space.
  3725.    n=0 deletes the TABs completely, resulting in a smaller file.
  3726.  
  3727.    Files which have been tagged in this way will show the TAB expansion used
  3728.    in parenthesis after the "Copy"; e.g., if you used n=4, you would see
  3729.    "Copy (4)" to the right of that file's display.  If bit-stripping was also
  3730.    used (see next section), you would see "Copy (b4)".
  3731.  
  3732.    As every byte must be scanned individually during the COPY process, TAB
  3733.    expansion is much slower than other copying.
  3734.  
  3735.  
  3736.    11.5.2  Bit-Stripping - [Alt+b]
  3737.  
  3738.    To get rid of the high-order bits that obscure the text in some files, tag
  3739.    the file(s) by pressing [Alt+b].  The new copy will have no high-order bits
  3740.    in it after the UPDATE is done.
  3741.  
  3742.    Files which have been tagged in this way will show "Copy (b)" to the right
  3743.    of the file's display.
  3744.  
  3745.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 11-4
  3746.  
  3747.  
  3748.  
  3749. |  Any requested TAB expansion (see previous section) is done before bit-
  3750. |  stripping is performed.  Thus, it is possible for the resulting file to
  3751. |  contain some TAB characters.  This would occur if the original file had
  3752. |  some bytes with the value 89h -- which become TABs after stripping.
  3753.  
  3754.  
  3755. |  11.6 Make a Copy in Working Directory
  3756. |
  3757. |  To make a copy of a file in the working directory (under a different name,
  3758. |  of course), one way is to set up EDDY.USE (see Section 14.1) to work with a
  3759. |  batch file that does the copy for you.  To illustrate this, a file called
  3760. |  EDDYCOPY.BAT has been included in the distribution package, along with a
  3761. |  corresponding entry in EDDY.USE (Example 13).  Read the comments in those
  3762. |  two files for details.
  3763. |
  3764. |  Just in case EDDYCOPY.BAT is missing from your EDDY package, here's what
  3765. |  you need:
  3766. |
  3767. |   1  @echo off
  3768. |   2  if &%1==& goto err
  3769. |   3  if &%2==& goto err
  3770. |   4  if not exist %2 goto doit
  3771. |   5  echo .
  3772. |   6  echo File %2 already exists
  3773. |   7  dir %2 /p
  3774. |   8  choice /c:yn "Overwrite "
  3775. |   9  if errorlevel 2 goto done
  3776. |  10  :doit
  3777. |  11  copy %1 %2
  3778. |  12  goto done
  3779. |  13  :err
  3780. |  14  echo Syntax:  EDDYCOPY  file-to-be-copied  filename-for-copied-file
  3781. |  15  :done
  3782. |
  3783. |  Nothing fancy, but it does the job.  Actually, you don't REALLY need more
  3784. |  than one line -- line 11 -- if you're the careful type.
  3785. |
  3786. |  If you are using a version of DOS that hasn't got a "choice" command,
  3787. |  you might replace lines 8 and 9 above by something like this...
  3788. |
  3789. |      echo If you don't want to overwrite, press [^c]
  3790. |      pause
  3791. |
  3792. |  While this capability COULD be implemented directly in EDDY, I think most
  3793. |  users will agree that more special keystrokes or new messages aren't
  3794. |  desireable when there's a simpler way to do things.
  3795. |
  3796. |  Actually, if you do this kind of copying often, I recommend that you make
  3797. |  your [Shift+F8] default command (see Section 14.2) something like:
  3798. |                        C:\BAT\EDDYCOPY  %f  %n%@
  3799. |  It's been left set up in EDDY.USE for ease and clarity of description.
  3800.  
  3801.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 12-1
  3802.  
  3803.  
  3804.  
  3805.    12.  MOVE Command - [F6], [^F6]
  3806.  
  3807.    You may move files and/or directories (and all their contents).  The
  3808.    Synchronization Controls (see Section 10) work closely with the MOVE
  3809.    command to help you in deciding which files you want to move.
  3810.  
  3811.    Moving a file places its entry in the target directory and deletes it from
  3812.    the working directory.  This is the same as doing a COPY and then a DELETE.
  3813.    The heading information showing the number of files in the display and the
  3814.    number of free bytes on the disk will be updated.
  3815.  
  3816.    The MOVE command actually just "tags" a file to indicate that it has been
  3817.    selected.  The word "Move" (or "Move+", if no file of the same name is
  3818.    currently in the target directory) will appear, to show the file has been tagged.
  3819.    The actual move will be done when you enter UPDATE mode.
  3820.  
  3821.    After UPDATE, "moved" will appear in the display for that file.  The
  3822.    display of size, date, etc., will be cleared, indicating that the file no
  3823.    longer exists in that directory.  If you re-sort the display, or move to
  3824.    another working directory and then return, files moved won't be displayed.
  3825.  
  3826.    If you have indicated other changes to be made to the file's directory
  3827.    entry (renaming, timestamping or attribute settings), these changes will be
  3828.    made during the UPDATE process, before the move is done.
  3829.  
  3830.    Files moved will normally have the archive attribute turned ON in the
  3831.    target directory (unless you are using option /A, or the target is on a
  3832.    remote disk).
  3833.  
  3834.    Also, if a file with the "network-shareable" attribute is moved, the result
  3835.    in the target will not have that attribute.
  3836.  
  3837.    Moved files normally receive the same date and time as the original; if
  3838.    you want to put the current timestamp on the moved files, use [^Enter] to
  3839.    start the UPDATE process, rather than [Enter].  If you use [^Enter], EDDY
  3840.    will ask you whether or not you want new timestamps.  (See also the
  3841.    discussion of the "timestamp" configuration parameter, in Section 30.3.2e).
  3842.  
  3843.    Changing the target while files are tagged for moving will result in these
  3844.    files being un-tagged.  EDDY will warn you if this would occur.
  3845.  
  3846.  
  3847.    12.1 MOVE a File - [F6]
  3848.  
  3849.    Press [F6] to select the current file to be moved.  If there is no target
  3850.    directory specified, EDDY will ask for one.  Entering target directories is
  3851.    explained in Sections 5.2.2 and 5.3.3.
  3852.  
  3853.    If the target directory contains a subdirectory that has the same name as
  3854.    the file you are trying to tag, EDDY will inform you of the conflict and no
  3855.    tagging will occur on that file.
  3856.  
  3857.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 12-2
  3858.  
  3859.  
  3860.  
  3861.    12.2 MOVE Multiple Files - [^F6]
  3862.  
  3863.    [^F6] will review all files in the working directory for moving, except
  3864.    those already tagged for COPY, MOVE, DELETE or DESTROY (or "Ignore").  All
  3865.    files (but NOT subdirectories) which meet the criteria defined by the
  3866.    Synchronization Controls (see Section 10) will be tagged for moving.
  3867.  
  3868.    As the list of files is being reviewed, [^c] or [BackSpace] may be pressed
  3869.    to terminate the process before all files have been reviewed.  If you just
  3870.    want to pause temporarily, to look at the screen or think about what's
  3871.    going on, press and hold [ScrollLock].  All processing will stop.  Release
  3872.    the key to continue.
  3873.  
  3874.    If you want EDDY to check only those files from the cursor and further
  3875.    down, turn on option /L before pressing [^F5].
  3876.  
  3877.    Using option /6 on the command line is the batch mode equivalent of [^F6].
  3878.    See Section 29 for more information on this.
  3879.  
  3880.  
  3881.    12.3 MOVE a Directory - [F6]
  3882.  
  3883.    This feature is sometimes called "prune and graft".  Press [F6] to tag the
  3884.    current subdirectory for moving.  If there is no target directory, EDDY
  3885.    will ask for one.  Entering target directories is explained in Sections
  3886.    5.2.2 and 5.3.3.  The target may be on a different drive from the working
  3887.    directory.
  3888.  
  3889.    If the target directory contains a file that has the same name as the sub-
  3890.    directory you are trying to tag, EDDY will inform you of the conflict and
  3891.    no tagging will occur on that subdirectory.
  3892.  
  3893.    Also, the target must not be in a path which includes the directory to be
  3894.    moved (i.e., you can't move a directory to its own child or other
  3895.    subordinate directory).
  3896.  
  3897.    If there is a subdirectory in the target with the same name, you will be
  3898.    asked if you wish to overwrite it.  If you do, the directory will be tagged
  3899.    for moving.  When you UPDATE, the subdirectory in the target, WITH ALL THE
  3900.    FILES AND SUBDIRECTORIES IN IT, will be deleted first and then replaced by
  3901.    the directory being moved and all ITS files and subdirectories.  There is
  3902.    no checking or comparison of file timestamps involved in this move process;
  3903.    it is a complete replacement of one tree by another.
  3904.  
  3905. |  When a subdirectory is moved, the timestamp will not be changed.
  3906.  
  3907.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 12-3
  3908.  
  3909.  
  3910.  
  3911.    12.4 Fast Directory Move
  3912.  
  3913.    If the working and target directories are on the same drive, it is possible
  3914.    to bypass the tedious file-by-file copying that is normally used in moving
  3915.    a directory.  As this is achieved by using techniques other than standard
  3916.    DOS services, EDDY will ask your preference before beginning the move
  3917.    process when you start the UPDATE.  Fast move cannot be used if a directory
  3918.    of the same name already exists in the target.
  3919.  
  3920.    EDDY speeds up the directory move task by writing directly to the working
  3921.    and target directories, and using DOS services where available.  No direct
  3922.    manipulation of the File Allocation Table (FAT) is involved.
  3923.  
  3924.  
  3925.    12.4.1 What Makes it Fast?
  3926.  
  3927.    This process has been exhaustively tested by the author and many users,
  3928.    without any problems.  However, some of us are hesitant (read
  3929.    "intelligent") about using programs that mess with our disks in
  3930.    non-standard ways.  Therefore, the following information is offered.
  3931.  
  3932.    Specifically, the steps EDDY uses internally during a "fast" subdirectory
  3933.    move are:
  3934.  
  3935.        1. Set the "directory" attribute OFF in the subdirectory's entry in
  3936.             the working directory, making DOS think the subdirectory is a file
  3937.        2. Move the "file" to the target directory, with the standard DOS
  3938.             "rename" command
  3939.        3. Turn the "directory" attribute back ON in the target directory
  3940.        4. Adjust the "cluster number" in the moved directory's ".." (parent)
  3941.           entry to point to the target rather than the working directory
  3942.  
  3943.    After a directory move, you may notice a lot of disk activity before the
  3944.    EDIT display reappears.  Don't be alarmed; the program is simply rereading
  3945.    all the information in both the working and target directories, to ensure
  3946.    that all the data displayed reflects the new tree structure.
  3947.  
  3948.  
  3949.    12.4.2 Had a Problem?  Don't Panic!
  3950.  
  3951.    If there is a problem with any of the above steps (e.g., a power failure
  3952.    during the update), recovery is straightforward.
  3953.  
  3954.    - If the subdirectory is still shown as a directory entry in the working
  3955.    directory, there's no problem.
  3956.  
  3957.    - If you have think there might have been a problem, and the entry is shown
  3958.    in the target as a directory, it's possible that step 4 was not completed.
  3959.    Run "CHKDSK" on the disk.  If CHKDSK displays the message "Invalid sub-
  3960.    directory entry", AND NO OTHER ERROR MESSAGES, run "CHKDSK /F" to fix the
  3961.  
  3962.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 12-4
  3963.  
  3964.  
  3965.  
  3966.    cluster number automatically.  If other errors are indicated (e.g., lost
  3967.    clusters, cross-linked files), they were present before EDDY ran, and
  3968.    should be fully understood and thought out before taking further action.
  3969.  
  3970.    - If there was a problem with step 3, the subdirectory will be shown as a
  3971.    "file" (i.e., no "directory" attribute) in the target, with a length of
  3972.    either one cluster -- typically, 4096 bytes -- or zero.  Don't panic!
  3973.    There's only one little bit that has to be changed.  To fix this problem,
  3974.    LOOK at the target, then LOOK at the disk to display the raw directory
  3975.    data.  Move the display until the entry for the "file" is at the top, and
  3976.    PATCH offset 0Bh to "10h".  Your directory is now restored.
  3977.  
  3978.    - If the subdirectory is shown as a "file" in the working directory, LOOK
  3979.    at the disk, and proceed as described in the previous paragraph.
  3980.  
  3981.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 13-1
  3982.  
  3983.  
  3984.  
  3985.    13.  DELETE Command - [F7], [^F7]
  3986.  
  3987.    To select the current file for deletion, press [F7].  No other changes may
  3988.    be made to a file that is selected for deletion.
  3989.  
  3990.    "Delete" appears next to the file.  The deletion will be done when you
  3991.    UPDATE, and "deleted" will appear.  All directory information (size, date,
  3992.    etc.) will be blanked out, indicating that the file no longer exists in
  3993.    that directory.  If you re-sort the display, files deleted won't be shown.
  3994.    The heading information showing the number of files in the display and the
  3995.    number of free bytes on the disk will be updated to reflect the deletion.
  3996.  
  3997.    If Synchronization Control #6 (see Section 10.4) is set to "N" (the
  3998.    default), [^F7] tags all files in the working directory for deletion,
  3999.    except those already tagged for COPY, MOVE or DESTROY (or "Ignore").
  4000.  
  4001.    If Control #6 is "Y", the other Controls determine which files will be
  4002.    tagged by [^F7], based upon a comparison of working and target directories.
  4003.    If Control #6 is "Y" and there is no target directory, you'll be asked for
  4004.    one.  If you don't enter a target, Control #6 will be treated as "N" for
  4005.    processing the current [^F7] command.
  4006.  
  4007.    To interrupt EDDY after [^F7], press [^c] or [BackSpace].  If you just want
  4008.    to pause temporarily, to look at the screen or think about what's going on,
  4009.    press and hold [ScrollLock].  All processing will stop.  Release the key to
  4010.    continue.
  4011.  
  4012.    Using option /7 on the command line is the batch mode equivalent of [^F7].
  4013.    See Section 29 for more information on this.
  4014.  
  4015.  
  4016.    13.1 Deleting Subdirectories
  4017.  
  4018.    Subdirectories may also be deleted, even if they are not empty.  EDDY will
  4019.    warn you that the directory is not empty when you press [F7], and ask
  4020.    whether you want to delete or not.  If you choose to proceed, all files in
  4021.    the directory, plus any subordinate subdirectories and all of their files,
  4022.    will be deleted when you UPDATE.
  4023.  
  4024.    In this type of deletion, no check is made for read-only file attributes on
  4025.    the files in the subdirectory -- they are all deleted without further
  4026.    question.  Obviously, this type of deletion should be done only when you
  4027.    are sure there's nothing important left in the directory.
  4028.  
  4029.    As the deletions are being made, the full path and file name of each file
  4030.    or subdirectory being deleted will be displayed prior to its deletion.  In
  4031.    the display, subdirectories are shown with a final "\" after the name, to
  4032.    distinguish then from files.
  4033.  
  4034.    As with other UPDATE actions, pressing a key during the UPDATE will suspend
  4035.    activity until you decide how you want to proceed.
  4036.  
  4037.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 13-2
  4038.  
  4039.  
  4040.  
  4041.    13.2 Logical DELETE (Ignore) - [Alt+F7], [Alt+^F7]
  4042.  
  4043.    Pressing [Alt+F7] flags a file with "(Ignore)".  It will then be ignored by
  4044.    any of the repeating (i.e., [Ctrl]-shifted) commands.  This lets you
  4045.    eliminate files from a list that you want to do a repeated FIND on, for
  4046.    example, not wasting time with files that are not of interest for the FIND.
  4047.    [Alt+F7] also undoes any changes that may be pending on the file.
  4048.  
  4049.    Pressing a key for any command which affects a logically deleted file
  4050.    cancels the "(Ignore)".  [Left] or [Right] also cancels the "(Ignore)".
  4051.  
  4052.    [Alt+^F7] flags all files with "(Ignore)".  Thus you can ignore all but a
  4053.    few files when executing the next command, such as [^f], the multi-file
  4054.    FIND, or [Shift+^F9], the multi-file Point-and-Shoot.  It's easier to
  4055.    "ignore all" and then UNDO the few, rather than ignoring one by one.
  4056.  
  4057.    "Ignore" is also useful when creating list files.  See Section 22 for more
  4058.    information on this.
  4059.  
  4060.  
  4061.    13.3 DESTROY - [Shift+F7], [Shift+^F7]
  4062.  
  4063.    If you want to protect the contents of deleted files from being snooped
  4064.    into by anyone, even using utilities designed for that purpose (such as
  4065.    EDDY), use "DESTROY".  DESTROYing means overwriting the file, thus
  4066.    trashing the data in it, and then deleting the file.
  4067.  
  4068.    To select the current file for destruction, press [Shift+F7].  "Destroy"
  4069.    appears next to the file.  The actual overwrite and deletion will be done
  4070.    when you enter UPDATE mode.
  4071.  
  4072.    If Synchronization Control #6 (see Section 10.4) is set to "N" (the
  4073.    default), [Shift+^F7] tags all files in the working directory for deletion,
  4074.    except those already tagged for COPY, MOVE or DELETE (or "Ignore").
  4075.  
  4076.    If Control #6 is set to "Y", then the other Controls are used to determine
  4077.    which files will be tagged by [Shift+^F7], based upon a comparison of
  4078.    working and target directory entries.  If Control #6 is "Y" and there is no
  4079.    target directory, you'll be asked for one.  If you don't enter a target,
  4080.    Control #6 will be treated as "N" for processing the [Shift+^F7] command.
  4081.  
  4082.    To interrupt EDDY after [Shift+^F7], press [^c] or [BackSpace].  If you
  4083.    just want to pause temporarily, to look at the screen or think about what's
  4084.    going on, press and hold [ScrollLock].  All processing will stop.  Release
  4085.    the key to continue.
  4086.  
  4087.    Using option /8 on the command line is the batch mode equivalent of
  4088.    [Shift+^F7].  See Section 29 for more information on this.
  4089.  
  4090.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 13-3
  4091.  
  4092.  
  4093.  
  4094.    13.3.1 Standard DESTROY Method
  4095.  
  4096.    The default method for DESTROY is to write all 0F5h bytes (a tall, thin
  4097.    "j"-like character) once over the entire file before deleting it.  If you
  4098.    are a secret agent or a government scientist, this may not be sufficient.
  4099.    If you require higher security, see the next Section.
  4100.  
  4101.    If a file has previously had some data deleted from the end, it is possible
  4102.    that some of that data is still physically on the disk, in the last disk
  4103.    cluster of the file, beyond the current end-of-file.  To ensure that this
  4104.    data cannot be snooped into either, the entire cluster is overwritten as
  4105.    just described, rather than stopping at the end-of-file.  Of course, if the
  4106.    file used to be long enough that it had more clusters allocated, any data
  4107.    left in those additional clusters won't be destroyed, as the information as
  4108.    to which clusters were allocated is no longer available.
  4109.  
  4110.    If you want to ensure that any data remaining in the currently-unallocated
  4111.    areas of the disk is also destroyed, EDDY provides for that, too.  After
  4112.    the first DESTROY is performed in an UPDATE, you will be asked whether you
  4113.    wish to overwrite those areas.  If you do, a temporary file is created with
  4114.    a size sufficient to occupy all free disk space, and 0F5h bytes written to
  4115.    all of it.  The file is then deleted, leaving the disk space free for use
  4116.    (and free of useful information).  See also Section 13.3.3.
  4117.  
  4118.    When the overwrite operation is complete, "destroyed" appears next to that
  4119.    file (when you return to EDIT), and all directory information is erased.
  4120.    The counts of the numbers of files in the display and the free bytes on the
  4121.    disk will be updated to reflect the deletion.
  4122.  
  4123.  
  4124.    13.3.2 High-Security DESTROY
  4125.  
  4126.    If you have unusually high-security requirements, and need to be sure that
  4127.    files you DESTROY cannot possibly be recovered, even with special-purpose
  4128.    equipment designed to recover data that has been overwritten, EDDY can meet
  4129.    your requirements.
  4130.  
  4131.    "High-security" means conforming to the U.S. government's specification for
  4132.    secure file destruction.  This involves overwriting the file on disk SEVEN
  4133.    times -- six times alternating with ones and zeros, the last time writing
  4134.    the character 0F6h (the "division" symbol).
  4135.  
  4136.    Of course, this method takes 7 times as long as a single overwrite pass.
  4137.  
  4138.    If you use the high-security DESTROY method, it will also be used if you
  4139.    choose to overwrite unallocated areas, described in the previous Section.
  4140.  
  4141.    Normally, EDDY will ask you which method to use each time you go to UPDATE
  4142.    (if any files have been tagged for DESTROY).  Or, you can customize to use
  4143.    either the high- or standard-security method always.  (See Section 30.3.2e,
  4144.    the "security" parameter.)
  4145.  
  4146.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 13-4
  4147.  
  4148.  
  4149.  
  4150.    13.3.3 DESTROY a DRIVE!
  4151.  
  4152.    This sounds a bit drastic, but taken in context it can be useful.  In
  4153.    Section 13.3.1 it was mentioned that after DESTROYing a file, you would be
  4154.    given the option of wiping out unallocated areas of the disk as well.  This
  4155.    is fine, except there may be times when there aren't any files you want to
  4156.    DESTROY, but you'd still like to wipe the currently-unallocated-but-maybe-
  4157.    containing-sensitive-data areas of the disk clean.
  4158.  
  4159.    To do this, just execute the DESTROY command (i.e., press [Shift+F7]) on
  4160. |  the "Drive..." line of the EDIT mode display.
  4161.  
  4162.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 14-1
  4163.  
  4164.  
  4165.  
  4166. |  14.  The EDDY.USE File
  4167. |
  4168. |  This file's primary purpose is to provide "Point & Shoot" functionality.
  4169. |
  4170. |  The EDDY.USE file may contain two types of information:
  4171. |
  4172. |    - File/application "associations" (similar to, but more powerful than the
  4173. |      MS Windows File Manager function of the same name).
  4174. |
  4175. |    - Printer Setup Commands
  4176. |
  4177. |  EDDY.USE may be created or modified with any editor or word processor which
  4178. |  can produce a simple ASCII text file.
  4179. |
  4180. |  A sample EDDY.USE is part of the EDDY distribution package.  This sample
  4181. |  has extensive explanatory comments.  I hope it will suggest ways in which
  4182. |  EDDY can help your system be easier and more convenient to use.
  4183. |
  4184. |  EDDY.USE (if present at all -- it's optional, but you'll be missing a lot
  4185. |  if you don't use it!) should ideally be in the same directory that you
  4186. |  executed EDDY from -- EDDY's "home" directory.  That's where EDDY looks for
  4187. |  it first, and so is fastest.  However, if your DOS version is earlier than
  4188. |  3.0, then EDDY.USE should be in a directory defined in your PATH variable,
  4189. |  as the home directory information is not available with DOS 2.x.
  4190. |
  4191. |  EDDY.USE may also contain comments if desired.  A comment is defined by a
  4192. |  line with a semi-colon as the first non-blank character.  Comments are
  4193. |  ignored by EDDY.
  4194. |
  4195. |
  4196. |  14.1 Point & Shoot Commands ("Associations") - [Shift+F9]
  4197. |
  4198. |  Point & Shoot refers to moving the cursor to a file you want to operate on
  4199. |  ("point") and pressing a key ("shoot") to begin the operation.  Windows
  4200. |  users will probably recognize this as "associating files with an
  4201. |  application".
  4202. |
  4203. |  You may define any commands you wish to be associated with any files you
  4204. |  choose.  An association is defined by a line in EDDY.USE.  Association
  4205. |  lines are displayed for your selection when you press [Shift+F9].
  4206. |
  4207. |  An association line has up to four parts:
  4208. |
  4209. |  - Command string (required)
  4210. |
  4211. |      This string is what will be executed if you choose this line after it
  4212. |      is displayed in response to [Shift+F9].  The specification of the
  4213. |      program to be executed must include the complete PATH to the directory
  4214. |      where the program is stored.
  4215.  
  4216.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 14-2
  4217.  
  4218.  
  4219.  
  4220. |      The command string may also contain a variety of "replaceable
  4221. |      parameters" (similar to, but more powerful than the standard DOS batch
  4222. |      file parameters).  These are explained in detail in Section 14.1.2.
  4223. |      The most common one is "%f", meaning "substitute here in the string the
  4224. |      current filename.ext from EDDY's display".
  4225. |
  4226. |  - File specification (required)
  4227. |
  4228. |      This defines the file or file type with which the command string is to
  4229. |      be associated.  The file specification is in normal DOS format, and
  4230. |      will usually include wildcards; e.g., "*.*", "*.DOC", "???.X" and
  4231. |      "FOO.BAR" (all without the quotes) are some valid possibilities.
  4232. |
  4233. |      In addition, If you want to associate a program with subdirectories,
  4234. |      use "<DIR>" instead of a file specification.  (Although, if you feel
  4235. |      you need such a program when EDDY is available, either you're not
  4236. |      familiar with the full range of capabilities EDDY offers, or you
  4237. |      probably have a requirement that would be a candidate for an upcoming
  4238. |      release of EDDY; if so, please let me know.)
  4239. |
  4240. |  - Modifiers
  4241. |
  4242. |      These are optional, one-byte indicators that further specify when the
  4243. |      line will be displayed for selection, whether or not swapping should be
  4244. |      used (see Section 15.3), and whether to pause after execution.  The
  4245. |      modifiers are defined in Section 14.1.1.
  4246. |
  4247. |  - Redirection string
  4248. |
  4249. |      Redirection or piping is optional.  If used, it is specified exactly as
  4250. |      it would be on the DOS command line.
  4251. |
  4252. |  An association line may be in either upper or lower case, or a mixture.
  4253. |  Case is not important, UNLESS it is meaningful to the command to be
  4254. |  executed.  Some programs, for example, have switches with different
  4255. |  meanings depending on case.  The general format of an association line is:
  4256. |
  4257. |    [modifiers]  file_specification  command_string  [redirection_string]
  4258. |
  4259. |  Examples of possible association lines are:
  4260. |
  4261. |                     *.DOC  C:\UTIL\EDIT\E  %f
  4262. |  and
  4263. |            ^| *.ZIP  C:\UTIL\PKZIP -v %f | C:\DOS\MORE
  4264. |
  4265. |  In the following discussions, references to "Example n" indicate particular
  4266. |  commands set up in the sample EDDY.USE that illustrate the use of the
  4267. |  parameter involved.
  4268.  
  4269.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 14-3
  4270.  
  4271.  
  4272.  
  4273. |  14.1.1 Modifiers
  4274. |
  4275. |  There are several, optional, one-byte codes which may be included in an
  4276. |  EDDY.USE association line to further define how that line is used.  Any,
  4277. |  all, or none of them may be present.  If present, the control codes must be
  4278. |  the first thing on the association line, and they must be adjacent to each
  4279. |  other -- not separated by blanks, for example.  The order of the flags is
  4280. |  irrelevant.  A blank following the modifier string signals to EDDY that the
  4281. |  next non-blank is expected to begin the file specification.
  4282. |
  4283. |  Here are the modifiers and corresponding meanings:
  4284. |
  4285. |    | (piping symbol): Pause after executing the command string.  This lets
  4286. |        you see what, if anything, has been displayed on the screen by the
  4287. |        program involved.  EDDY will wait for a keypress before proceeding.
  4288. |        (Examples 1, 4, 5, etc.)
  4289. |
  4290. |        A pause will always be used, regardless of whether the "|" is
  4291. |        present, if you have edited the association line before selecting it.
  4292. |
  4293. |        In any case, after a command has been executed, the value of DOS's
  4294. |        ERRORLEVEL variable is checked.  If it is non-zero, there will always
  4295. |        be a pause, and the ERRORLEVEL value will be displayed.
  4296. |
  4297. |    ^ (caret): Don't use this association line when operating on ALL files in
  4298. |        the display (i.e., when EDDY.USE was accessed by [Shift+^F9] -- see
  4299. |        Section 14.1.5 -- rather than by [Shift+F9]).  (Example 7)
  4300. |
  4301. |    ! (exclamation point): Use EDDY's memory-swapping mechanism to allow
  4302. |        maximum memory to be available for the program to be executed, even
  4303. |        if the "swap file" parameter (see Section 15.3) is set to "none".
  4304. |        (Example 6)
  4305. |
  4306. |    # (pound sign): This has a different effect than the other modifiers.
  4307. |        Rather than affecting behavior of the current line, it defines the
  4308. |        purpose of the current line, which in turn modifies the behavior of
  4309. |        lines that follow it.  See Section 14.4.4 for more information.
  4310. |
  4311. |
  4312. |  14.1.2 Replaceable Parameters
  4313. |
  4314. |  Replaceable parameters are two- or three-byte strings beginning with a "%".
  4315. |  When one of these is found within a command string from EDDY.USE, it is
  4316. |  replaced by the corresponding value before the command is displayed.
  4317. |
  4318. |  There is a comprehensive set of replaceable parameters provided for use
  4319. |  with EDDY.USE command strings.
  4320. |
  4321. |  In addition to the parameters described below, you may also include DOS
  4322. |  environment variables as replaceable parameters in your commands, exactly
  4323. |  as used in DOS batch files; i.e., enclosing the variable name within "%"s
  4324.  
  4325.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 14-4
  4326.  
  4327.  
  4328.  
  4329. |  results in the corresponding value from the DOS environment memory segment
  4330. |  being substituted (EDDY.USE, Examples 2, 4, 7).
  4331. |
  4332. |  Available parameters are:
  4333. |
  4334. |  - %w  = Path string of working directory (Examples 1, 10)
  4335. |
  4336. |          There is no terminating "\" at the end of the substituted string.
  4337. |          So if you want to append a filename, for example, to the path
  4338. |          string, you must use "%w\foo.bar" rather than "%wfoo.bar".
  4339. |
  4340. |  - %w: = Drive letter (and a ":", but no "\") of the working directory
  4341. |
  4342. |  - %t  = Path string of target directory (Examples 1, 10)
  4343. |
  4344. |          Same rules as for "%w".
  4345. |
  4346. |  - %t: = Drive letter (and a ":") of the target directory
  4347. |
  4348. |  - %f  = Current (i.e., highlighted in EDIT display) filename.ext.
  4349. |          (Examples 3, 4, 5, ...)
  4350. |
  4351. |          NOTE: For compatibility with earlier versions, "%1", or a
  4352. |          standalone "%", with a space on either side of it, is treated the
  4353. |          same as "%f".  (Example 2)
  4354. |
  4355. |  - %n  = "filename" portion of "filename.ext" (Examples 10, 11, 13)
  4356. |
  4357. |  - %e  = "ext" part of "filename.ext"
  4358. |
  4359. |          Thus, "%n.%e" yields the same result as "%f".
  4360. |
  4361. |          At least one of these last 3 -- "%f", "%n" or "%e" -- should be
  4362. |          used in most command strings (unless the command doesn't need to be
  4363. |          told what files to operate on).
  4364. |
  4365. |  - %h  = Path string of EDDY's "home" directory (Example 13)
  4366. |
  4367. |          Same rules as for "%w".
  4368. |
  4369. |  - %%  = "%" required in command string
  4370. |
  4371. |          If you have a file with a name that includes a "%", or you need a
  4372. |          "%" in a command line, use "%%" to put a single "%" in the string.
  4373. |
  4374. |  - %@  = Cursor position (Examples 3, 10, 13)
  4375. |
  4376. |          This parameter is not actually replaceable, but instead marks the
  4377. |          spot within the command where you wish to have the cursor placed
  4378. |          when the command is displayed.  This saves keystrokes when used
  4379. |          with commands that often need some editing before they are used.
  4380.  
  4381.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 14-5
  4382.  
  4383.  
  4384.  
  4385. |  When you select an association line to execute, EDDY checks to be sure that
  4386. |  all replaceable parameters have actually been replaced.  If not, you will
  4387. |  be warned and asked whether to proceed or not.
  4388. |
  4389. |  Examples of when this might occur are an environment variable that's not
  4390. |  defined, or use of "%t" when there's no target directory.
  4391. |
  4392. |
  4393. |  14.1.3 Selecting an Association
  4394. |
  4395. |  When an association line is displayed, you may edit it if necessary (except
  4396. |  as described in Section 14.1.5), or use it as-is.  Press [Enter], or
  4397. |  [Shift+F9] a second time to select the association line.  The current file
  4398. |  will then be operated on by the defined (possibly edited) command.
  4399. |
  4400. |  For example, if EDDY.USE contains the line:
  4401. |
  4402. |                          *.ZIP  C:\UTIL\PKZIP -v  %f
  4403. |
  4404. |  pressing [Shift+F9] with the cursor on EXAMPLE.ZIP will give the display:
  4405. |
  4406. |                        C:\UTIL\PKZIP -vm   EXAMPLE.ZIP
  4407. |
  4408. |  and pressing [Enter] will list the contents of EXAMPLE.ZIP (assuming, of
  4409. |  course, that you have PKZIP in the UTIL directory).
  4410. |
  4411. |  EDDY.USE may contain more than one association line for a particular file,
  4412. |  including one or more "*.*" entries which will match all files (but see the
  4413. |  next section for a way to redefine "all").
  4414. |
  4415. |  When you press [Shift+F9], the first EDDY.USE line that matches the current
  4416. |  file will be displayed.  If you press [Down], the next matching line in
  4417. |  the file, if any, will be displayed. [Up] returns to the preceding matched
  4418. |  line.  If you press [Down] and there are no more matching lines in
  4419. |  EDDY.USE, EDDY's "default command" (see Section 14.2) will be displayed.
  4420. |
  4421. |  If there are no matching lines at all in EDDY.USE, only the default command
  4422. |  will be displayed.
  4423. |
  4424. |  It's suggested, but not required, that you place your "*.*" lines at the
  4425. |  end, so that they're used as a "last resort" after the lines containing
  4426. |  more restrictive file specifications have been checked.
  4427. |
  4428. |
  4429. |  14.1.4 "*.*"-ish Selection
  4430. |
  4431. |  When "*.*" is used, you would normally expect it to match any filename.
  4432. |  However, EDDY tries to be a LITTLE selective:  By default, any ".COM" or
  4433. |  ".EXE" files will not cause a match, as most applications don't operate on
  4434. |  files of those types.
  4435.  
  4436.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 14-6
  4437.  
  4438.  
  4439.  
  4440. |  If you DO want to associate such files with an application, you can do it
  4441. |  explicitly, with a file specification of "*.COM" and/or "*.EXE", or you can
  4442. |  override the default behavior.
  4443. |
  4444. |  To override, put a line in EDDY.USE that begins with a "#" and then list
  4445. |  the extensions, separated by commas, that you wish to exclude from matching
  4446. |  with "*.*" association lines.  The extensions may include wildcards, and do
  4447. |  not necessarily have to be 3 bytes long.  (Examples 8, 11, 12)
  4448. |
  4449. |  To include in the list files that don't have an extension, make the first
  4450. |  or last byte in the list a comma. (Example 11)
  4451. |
  4452. |  A maximum of 25 extensions may be included in the list.
  4453. |
  4454. |  You may use multiple "#" lines, which is useful when you have several "*.*"
  4455. |  association lines whose command strings work with different types of files.
  4456. |  Each "#" line overrides any that precede it.
  4457. |
  4458. |  If you want to make "*.*" act like you'd normally expect -- i.e., match
  4459. |  everything -- use a line that has ONLY a "#".  This means nothing is to be
  4460. |  excluded.
  4461. |
  4462. |
  4463. |  14.1.5 Multi-File Operations - [Shift+^F9]
  4464. |
  4465. |  If you use [Shift+^F9], you tell EDDY that the association line you select
  4466. |  from EDDY.USE is to be considered for use on EVERY file in the current
  4467. |  working directory display, STARTING FROM THE CURRENT FILE and moving down
  4468. |  (just as though option /L were ON with other repeating commands).
  4469. |
  4470. |  The matching of files to association lines is the same as with [Shift+F9],
  4471. |  EXCEPT if the association line contains a "^" modifier, it is ignored.
  4472. |
  4473. |  Also, any files tagged as "Ignore" will be skipped when processing a
  4474. |  [Shift+^F9], allowing you to operate on a selected subset of the files in
  4475. |  your working directory, even though there may be others with matching file
  4476. |  specifications.
  4477. |
  4478. |  After selection, for each file in the working directory display, if it
  4479. |  matches because of a "*.*" file specification, and the current file's
  4480. |  extension is in the "excluded extensions" list, as described in the
  4481. |  preceding section, the file is skipped.
  4482. |
  4483. |  Association lines may NOT be edited when used in a multi-file operation.
  4484. |
  4485. |  After the command has been executed on each file, you may interrupt the
  4486. |  process if you wish, so it will not continue executing on the rest of the
  4487. |  files in the display.  If there is a pause after execution ("Press a key"),
  4488. |  press [^c] to interrupt.  If there is no pause, then you must be a little
  4489. |  quicker.  In this case, press [^c] while the EDIT mode screen is displayed
  4490. |  between executions (you have approximately 1/4 second).
  4491.  
  4492.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 14-7
  4493.  
  4494.  
  4495.  
  4496. |  14.2 Default Command
  4497. |
  4498. |  As mentioned above, when EDDY runs out of matching association lines in
  4499. |  EDDY.USE, after a [Shift+F9], the "default command" is displayed.  While
  4500. |  the default command is not actually contained in EDDY.USE (it's stored
  4501. |  in EDDY.COM), it's so closely related that its description fits best here.
  4502. |
  4503. |  The default command format is the same as the "command string" field
  4504. |  described above for "association lines" in EDDY.USE, including the same set
  4505. |  of replaceable parameters.  A "redirection string" may also be used.
  4506. |  Excluded file extensions defined by EDDY.USE (see Section 14.1.4) do NOT
  4507. |  apply to the default command.  It will be offered as a choice for execution
  4508. |  on any file.
  4509. |
  4510. |  You may also select the default command directly, without using EDDY.USE.
  4511. |
  4512. |
  4513. |  14.2.1  Select Default Command - [Shift+F8]
  4514. |
  4515. |  Press [Shift+F8] to get a dialog box showing the current default command.
  4516. |  This command may be used as-is, edited and then used, or replaced entirely
  4517. |  by whatever command you want to use on the current file.  Press [Enter], or
  4518. |  [Shift+F8] again to execute the command.
  4519. |
  4520. |  (Actually, [F8] acts the same as [Shift+F8].  The latter form is used to
  4521. |  emphasize the similarity with [Shift+F9].)
  4522. |
  4523. |  An un-customized version of EDDY has a default of "C:\UTIL\DOS2UNIX  %f".
  4524. |  The "%f" is the same replaceable parameter described in Section 14.1.1,
  4525. |  marking the place in the command where the current filename will be
  4526. |  inserted.  This is included as an example only, and probably won't be
  4527. |  suitable for your system.
  4528.  
  4529.  
  4530. |  14.2.2 Editing the Default Command
  4531. |
  4532. |  When you edit the default command from the display, EDDY will ask whether
  4533. |  you want to save it as the new default, and whether to pause after
  4534. |  executing it, to allow time for you to read anything that may have been
  4535. |  displayed on the screen as a result of executing the command.
  4536. |
  4537. |  If you save the command as the new default, it will remain in effect for
  4538. |  the rest of that execution, or until modified again.  To make it a
  4539. |  permanent default, edit and save it when you are customizing (see Section
  4540. |  30.1), or use the "command" parameter in EDDY.INI (see Section 30.3.2g).
  4541. |
  4542. |  Default commands are displayed with any replaceable parameters (see Section
  4543. |  14.1.2) already replaced.  If you edit and save the command, before it is
  4544. |  saved it is scanned to see whether any part of the command is equivalent to
  4545.  
  4546.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 14-8
  4547.  
  4548.  
  4549.  
  4550. |  the replaceable parameters "%w", "%t" "%f", "%n" or "%e".  If so, the
  4551. |  replaceable parameter is used in the saved command, rather than the
  4552. |  verbatim string as displayed.
  4553. |
  4554. |  For example, if your working directory is C:\DOS, your target is D:\TEMP,
  4555. |  and the cursor is on the file CHKDSK.COM, you might have edited the command
  4556. |  to look like this:
  4557. |                  C:\UTIL\BLETCH  C:\DOS\CHKDSK.COM  D:\TEMP
  4558. |  If you save the command, your new default would actually be stored as:
  4559. |                           C:\UTIL\BLETCH  %w\%f  %t
  4560. |  so that the name of the current file and working/target directory will be
  4561. |  replaced in the command for each new file you use it on.  Your decision as
  4562. |  to whether to pause after executing the command is also saved.
  4563.  
  4564.  
  4565. |  14.2.3 Multi-file Operations - [Shift+^F8]
  4566.  
  4567.    With [Shift+^F8], the command will by default be executed only on files
  4568.    from the display that have the SAME extension as the current file.
  4569.    However, you will be asked before execution starts whether you want to
  4570.    operate on all files (i.e., "*.*").
  4571.  
  4572. |  As with [Shift+^F9], the command will be executed first on the current
  4573. |  file, and then on files below that in the EDIT display, with any files
  4574. |  tagged as "Ignore" being skipped.
  4575.  
  4576. |  The default command may NOT be edited when used in a multi-file operation.
  4577.  
  4578. |  To interrupt the processing of multiple files, use [^c] as explained in
  4579. |  Section 14.1.5.
  4580.  
  4581.  
  4582. |  14.3 Printer Control - [Alt+9]
  4583.  
  4584.    At the end of EDDY.USE, there is a section where printer control strings
  4585.    (commands) may be defined, allowing you to configure your printer from
  4586.    within EDDY.
  4587.  
  4588. |  This section starts with a line containing "[printer]" (without quotes).
  4589. |  If you are going to use printer commands in EDDY.USE, this line MUST be
  4590. |  present.  It tells EDDY where "associations" (see Section 14.1) end and
  4591. |  printer commands begin.
  4592.  
  4593.    Some examples of typical printer commands:
  4594.  
  4595.         ESC,':'            ; Set 12 cpi pitch for Canon BubbleJet
  4596.         ESC,'X',8,96       ; Set horizontal margins 8-96 for Canon BubbleJet
  4597.         DC2,SI             ; Set 17 cpi for IBM ProPrinter
  4598.         ESC,'&k4s'         ; Set 12 cpi for HP LaserJet
  4599.  
  4600.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 14-9
  4601.  
  4602.  
  4603.  
  4604. |  14.3.1 Command Format
  4605.  
  4606. |  Printer commands in EDDY.USE are created according to the following rules:
  4607.  
  4608.    1.  The standard ANSI names for the characters from 0 thru 32 (decimal) are
  4609.        recognized; e.g., NUL, CR, SO, DC2, ESC, SP, etc.  These names should
  4610.        not be enclosed in quotes.
  4611.  
  4612.    2.  Unquoted numbers are decimal, and must be in the range 0-255.
  4613.  
  4614.    3.  Decimal numbers may be used instead of ANSI names or quoted
  4615.        characters, if you prefer.
  4616.  
  4617.    4.  Strings are terminated by a space or semi-colon which is not enclosed
  4618.        in quotes.
  4619.  
  4620.    5.  To include a space, comma or semi-colon as part of a command string,
  4621.        enclose them in single quotes; i.e., ' ', ',' or ';'.
  4622.  
  4623.    6.  Strings surrounded by single quotes are used as-is.  To include a
  4624.        single quote as part of a command string, use two single quotes in a
  4625.        row within a quoted string.  For example, 'ab''cd' is interpreted as
  4626.        a string containing the following 5 bytes:  ab'cd.  If the single
  4627.        quote is the ONLY character in a quoted string, use '''' -- that's
  4628.        two consecutive single quotes within a quoted, one-byte string.
  4629.  
  4630.  
  4631. |  14.3.2 Command Selection
  4632. |
  4633. |  To select a printer command, press [Alt+9] while in EDIT or LOOK mode.
  4634. |  Moving through the list of strings available is the same as for association
  4635. |  lines (see Section 14.1.3), using [Down] and [Up].  When the command you
  4636. |  wish to use is displayed, press [Enter] to send it to the printer.
  4637. |
  4638. |  Unlike association lines, printer commands can't be edited when they are
  4639. |  displayed.
  4640. |
  4641. |  After you send a command to the printer, the [Alt+9] window remains on
  4642. |  screen, allowing you to select additional commands as desired.
  4643.  
  4644.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 15-1
  4645.  
  4646.  
  4647.    15.  DOS Gateway
  4648.  
  4649.    EDDY allows you to exit to DOS (the DOS "shell"), execute other commands or
  4650.    programs, and return to EDDY to pick up where you left off.  All requested
  4651.    changes and actions will still be in effect when you return.
  4652.  
  4653. |  When you exit to DOS, you may maximize the memory made available to DOS by
  4654. |  using a swap file, as described in Section 15.3.
  4655.  
  4656.  
  4657.    15.1 The DOS Shell - [F9]
  4658.  
  4659. |  From EDIT or LOOK mode, pressing [F9] twice (or [F9] followed by [!], as
  4660. |  explained in Section 15.3) exits to DOS.
  4661.  
  4662.    When you exit, EDDY loads a new copy of COMMAND.COM (or whatever command
  4663. |  interpreter you use, based on the "COMSPEC" environment variable -- e.g.,
  4664.    4DOS), which will process your DOS commands normally.  The screen is
  4665.    cleared, followed by the command interpreter's usual announcement of its
  4666.    presence, and then the DOS prompt.
  4667.  
  4668.    The DOS default directory will be EDDY's working directory.  You may change
  4669.    this if you wish.  EDDY will restore it when you return.
  4670.  
  4671.    When you're ready to return to EDDY, type "EXIT" at the DOS command prompt.
  4672.  
  4673.    If you forget to EXIT, you may run short of memory later on, because memory
  4674.    remains assigned to both EDDY and the extra copy of the command interpreter
  4675.    To remind you to EXIT, EDDY changes the DOS prompt to end with "Exit>".  If
  4676.    you don't want this reminder added to your prompt, see the description of
  4677.    the "prompt" configuration parameter in Section 30.3.2g.
  4678.  
  4679. |  More information on EDDY's use of environment space is in Section 15.4
  4680.  
  4681.  
  4682.    15.2 Execute .COM, .EXE or .BAT File - [Alt+F9]
  4683.  
  4684.    When the cursor is on a file with an extension of "COM", "EXE" or "BAT" (or
  4685.    "BTM" if you're using 4DOS or NDOS), pressing [Alt+F9] executes that file.
  4686.  
  4687.    The filename is first displayed in a dialog box, so that you may edit the
  4688.    command line if you like, to add filenames, switches, redirection, or
  4689.    whatever is appropriate for the file involved.
  4690.  
  4691.    When you are ready to execute the file, press [Enter], or [Alt+F9] again.
  4692.  
  4693.    When the program or batch file finishes, EDDY waits for a key to be
  4694.    pressed.  This pause allows time for you to read anything that may have
  4695.    been displayed on the screen by the process which was just executed.
  4696.  
  4697.    If the ERRORLEVEL value was set to anything other than zero by the process,
  4698.    that value is displayed also.
  4699.  
  4700.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 15-2
  4701.  
  4702.  
  4703.  
  4704.    15.3 Using a Swap File
  4705.  
  4706.    When you use the DOS Gateway or execute programs via Point & Shoot, EDDY
  4707.    tries to swap part of itself out to disk, to make more memory available for
  4708.    the process to be run.
  4709.  
  4710. |  EDDY, by default, inhibits swapping.  If you customize EDDY to include a
  4711. |  "swap path" (see Section 30.3.2g), the swap file will be created in the
  4712. |  directory you have chosen.  If no swap path has been specified, the path
  4713. |  indicated by the "TEMP" environment variable, if any, will be used.  If
  4714. |  neither the swap path nor the TEMP variable are available, no swap will
  4715. |  occur.
  4716. |
  4717. |  The trade-off, of course, is execution time versus memory availability.
  4718. |  With swapping, the associated i/o takes an extra bit of time (although this
  4719. |  can be minimized by specifying a swap path on a RAM disk).
  4720. |
  4721. |  If you're going to do things that require a lot of memory, however, you
  4722. |  should consider using swapping.  At least 120K of memory, and sometimes as
  4723. |  much as 180K, will be freed when swapping is used.
  4724. |
  4725. |  If swapping is inhibited, and you find there's not enough memory to do what
  4726. |  you require, you may still tell EDDY to swap when you use the DOS Gateway.
  4727. |  After pressing [F9] to invoke the Gateway, as explained above, if you then
  4728. |  press [!] instead of [F9] to confirm, EDDY will attempt to use the path
  4729. |  given by the "TEMP" variable to create a swap file.
  4730. |
  4731. |  The swap file name will consist of 8 apparently random letters generated by
  4732. |  DOS from the current system time, and guaranteed by DOS to be unique within
  4733. |  its directory.
  4734.  
  4735.    The swap file is deleted when EDDY terminates.
  4736.  
  4737.  
  4738. |  15.4 Environment Space
  4739. |
  4740. |  EDDY has an internal buffer of just over 10K bytes which is not easily
  4741. |  swappable, but is otherwise unused during DOS Gateway operations.  Rather
  4742. |  than let it be wasted completely, it is normally set up as an unusually
  4743. |  large, simulated environment for the DOS Gateway or any child process,
  4744. |  including Point & Shoot.  So you shouldn't often run out of environment
  4745. |  space when running under EDDY's control.
  4746. |
  4747. |  Within this buffer, the new prompt string is constructed, with "Exit$g",
  4748. |  which displays as "Exit>", appended (see Section 15.1).
  4749. |
  4750. |  Only if you are already using a larger environment than this will EDDY use
  4751. |  the DOS default environment size, and in that case the "Exit>" would not be
  4752. |  used, either.
  4753.  
  4754.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 16-1
  4755.  
  4756.  
  4757.  
  4758.    16.  QUIT Command - [F10], [Esc]
  4759.  
  4760.    When you are through with EDDY, press [F10].  [F10] will restore your
  4761.    DOS default drive and directory to the settings they had when you executed
  4762.    EDDY (or to your "recall" directory, if you have selected one as described
  4763.    below).  EDDY will terminate immediately and return to DOS.
  4764.  
  4765.    If you have changes pending which have not yet been processed by UPDATE,
  4766.    EDDY will remind you that there are such changes, and ask you to confirm
  4767.    that you want to QUIT anyway.
  4768.  
  4769.    One exception to this may occur when option /K is used.  Pressing [F10]
  4770.    when a message is displayed and waiting for a key press will only erase the
  4771.    message (like any other key).  You must press [F10] again to terminate.
  4772.  
  4773.    Some users prefer to use [Esc] as a way to QUIT from EDIT.  If you want to
  4774. |  QUIT by using [Esc], just press it twice, or press it and hold it down.
  4775.  
  4776.  
  4777.    16.1 Directory Recall - [Shift+F10], [Shift+^F10]
  4778.  
  4779.    [Shift+F10] selects the working directory as the "recall" directory.
  4780.    Directory recall is a "place-holding" mechanism, used in two ways:  1) When
  4781.    you exit from EDDY, this directory will be set as the DOS default, and 2)
  4782.    If you press [Shift+^F10], the directory will be "recalled" as the new
  4783.    working directory.  If no recall directory is selected, the DOS default
  4784.    directory, as it was before you executed EDDY, will be used.
  4785.  
  4786.  
  4787.    16.2 Exit to Directory - [Alt+F10]
  4788.  
  4789.    [Alt+F10] exits from EDDY -- just like [F10] -- but leaves the working
  4790.    directory as the DOS default.
  4791.  
  4792.    [Alt+F10] may also be used from the directory tree diagram display (see
  4793.    Section 5.3.2).  If you press [Alt+F10] in that case, EDDY will exit,
  4794.    making the directory that is currently highlighted the new DOS default.
  4795.  
  4796.  
  4797.    16.3 EGA and VGA Display Control - [^F10]
  4798.  
  4799.    If you have an EGA or VGA monitor, EDDY normally resets the display to the
  4800.    same number of lines that were in use when EDDY was executed.  However, if
  4801.    you use [^F10] to quit, the result is the same as [F10], except the display
  4802.    will be left with the number of lines per screen you have set (by using
  4803.    option /E) while in EDDY.
  4804.  
  4805.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 16-2
  4806.  
  4807.  
  4808.  
  4809. |  16.4 Final Screen
  4810. |
  4811. |  When you exit from EDDY, with an unregistered version you'll see a display
  4812. |  roughly (for an actual image, see EDDY_FIG.DOC) like this:
  4813. |
  4814. |                    |===================================|
  4815. |                    | THANK YOU for using EDDY(tm) v.8c |
  4816. |                    |   Copyright(C) 1987 thru 1996     |
  4817. |                    |       All rights reserved         |
  4818. |                    |        by  John Scofield          |
  4819. |                    |    117, West Harrison Building    |
  4820. |                    |      6th floor,  Dept. S-678      |
  4821. |                    |         Chicago, IL 60605         |
  4822. |                    |     Internet:Scofield@ACM.org     |
  4823. |                    |       CompuServe:70162,2357       |
  4824. |                    |===================================|
  4825. |                    |===================================|
  4826. |                    |UNREGISTERED - EVALUATION COPY ONLY|
  4827. |                    |===================================|
  4828. |
  4829. |                                  Figure 16-1
  4830. |
  4831. |  With a registered copy, the last three lines are replaced by:
  4832. |                        "Registered to: <Your Name>"
  4833. |
  4834. |  If you have been using an unregistered copy often, for a lengthy period (a
  4835. |  combination of time and frequency), before the above display appears you'll
  4836. |  be asked to consider registering, and given a chance to print the
  4837. |  registration form.
  4838.  
  4839.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 17-1
  4840.  
  4841.  
  4842.  
  4843.    17.  FIND and/or REPLACE String in File, Disk or RAM
  4844.  
  4845.    To find a string, press [Alt+f] when the EDIT mode cursor is on that
  4846.    display entry, or when in LOOK mode.  (In LOOK mode, [/] or [\] have the
  4847.    same effect as [Alt+f].) If you want to search through all files in the
  4848.    working directory, press [^f] -- see Section 17.5.
  4849.  
  4850.    As an example, suppose you were using EDDY to LOOK at this file
  4851.    ("EDDY.DOC") and were positioned to the "Technical Support" section.  If
  4852.    you pressed [Alt+f], the display would be similar to Figure 17-1.
  4853.  
  4854.    The second line in the window shows a series of "5F"s and underlines.  The
  4855.    underlines have no special significance.  They only mark the place to enter
  4856.    the string you want EDDY to find.
  4857.  
  4858.    When you have entered the string EDDY is to search for, press [Enter] for a
  4859.    "close" match search or [^Enter] for an exact match.
  4860.  
  4861.  
  4862.                    * * *  (text continues on next page)  * * *
  4863.  
  4864. EXAMPLE "FIND" SCREEN:
  4865. ================================================================================
  4866. bug, surely!), if you take the trouble to report it, I'll try to solve it.
  4867. And I'll get back to you with a fix, if possible.
  4868.  
  4869. EDDY's PATCH command, using an area within EDDY reserved for this purpose,
  4870. makes it reasonably easy to fix minor bugs without having to wait for a whole
  4871. new version of the program.
  4872.  
  4873. With any problem report, please include the following information:
  4874.  
  4875.     1. Version number of your copy of EDDY (as shown on the logo
  4876. |------------------------------------------------------------------------------+
  4877. |                  Enter new FIND string, or use this one...                   |
  4878. |          5F 5F 5F 5F 5F 5F 5F 5F 5F 5F 5F 5F 5F 5F 5F 5F     ________________|
  4879. |                                                              ^               |
  4880. |           [Enter] to FIND "close" match, [^Enter] for exact match            |
  4881. |                                                                              |
  4882. |                     Global match is:"?"  [Alt+g] to change                   |
  4883. |------------------------------------------------------------------------------+
  4884.     5. As complete a description of the problem as possible -
  4885.        - what did you enter on the command line?
  4886.        - [PrtSc] listings of the screen before and after the problem
  4887.        - how was EDDY's output different from what you expected?
  4888.        - any other information that seems relevant
  4889.  
  4890. -LOOK-   EDDY.DOC      bits=8  tab=8  line=1357      [F1]:HELP     [Alt+F1]:MENU
  4891. ================================================================================
  4892.  
  4893.                                   Figure 17-1
  4894.  
  4895.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 17-2
  4896.  
  4897.  
  4898.  
  4899.    A "close" match will ignore upper and lower case differences.  One or more
  4900.    blanks in the string will match any number of consecutive blanks, carriage
  4901.    returns, line feeds or TABs (or any combination).  A close match will also
  4902.    find words that have been hyphenated and broken across two lines.  If you
  4903.    enter "bicycle" and then ask EDDY for a "close" match, it will find "bicy-
  4904.    cle" (i.e., broken at the end of the line) as well as any other occurrence
  4905.    of "bicycle".
  4906.  
  4907.    An exact match requires that every character match completely, including
  4908.    case and blanks.  Exact match FINDs are much faster than "close" matches.
  4909.  
  4910.    Once you have entered a string, that string becomes the default for any
  4911.    later FINDs, on the same file or any file you subsequently LOOK at.  In
  4912.    LOOK mode, press [f] or [/] to repeat the previous FIND, using the same
  4913.    string and the same type of match (close or exact).
  4914.  
  4915.    When EDDY finds the string, it goes to LOOK mode with the line containing
  4916.    the string at the top.  The first byte of the string is highlighted, and it
  4917.    blinks.  If there are long lines, and the string is off-screen, EDDY will
  4918.    move the display window to show the string.
  4919.  
  4920.    If the string begins with a carriage return or line feed, the display will
  4921.    be in hex format, even if it was in ASCII when the search began.  This is
  4922.    because these characters are used as line break controls, and do not appear
  4923.    in an ASCII display itself; therefore, hex format is used.
  4924.  
  4925.    If the string was not found, EDDY will "beep", the message "Not found" will
  4926.    be displayed, and the last page  of the file will be shown.
  4927.  
  4928.    You may interrupt EDDY's search by pressing any key.
  4929.  
  4930. |  NOTE:  When FINDing strings in RAM, you might expect there'd be a copy of
  4931. |  the string somewhere in EDDY's address space, to match against.  You're
  4932. |  right, but it (them, actually) is explicitly ignored, on the assumption
  4933. |  that you're not interested in the internal workings of EDDY.
  4934.  
  4935.  
  4936.    17.1 Entering New FIND Strings
  4937.  
  4938.    The dialog box for FIND (and FIND & REPLACE -- see Section 17.6) is
  4939.    different from other dialog boxes.  This is because of the requirement to
  4940.    enter two incompatible data formats (hex and ASCII) on the same line.
  4941.  
  4942.    You may notice that the line where you enter strings looks a lot like
  4943.    EDDY's PATCH mode display.  In fact, the same data entry routines are used,
  4944.    and you enter your string just as though you were patching this line.
  4945.  
  4946.    Values 00 - 7Eh may be entered in ASCII format.  00h - 19h may be entered
  4947.    by using the [Ctrl]-shifted keys:  [^@], [^a], etc.  In hex, all values may
  4948.    be entered.  [Tab] toggles between hex and ASCII; if you don't like [Tab]
  4949.    for this purpose, see Section 8.2.1a.  If [Tab] is not the toggle key, it
  4950.    can be used to enter TAB (09h) bytes in ASCII format.
  4951.  
  4952.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 17-3
  4953.  
  4954.  
  4955.  
  4956.    If any part of the string is entered in hex, or if the string has a hyphen
  4957.    in it, matches to words broken over two lines will not be found.
  4958.  
  4959.    Under the data entry line, marking the end of the string, is an up arrow
  4960.    (shown in Figure 17-1 as "^").  This arrow normally points to the last
  4961.    character entered, although you may move back to change a character if you
  4962.    make a mistake, and the arrow won't move.  To mark the end of the string at
  4963.    another place, move the cursor to that place and press [End].
  4964.  
  4965.    If you begin entering characters in the first (leftmost) position of the
  4966.    string, EDDY erases whatever previous string was there and accepts your
  4967.    input as a completely new string.  However, if you move the cursor to some
  4968.    position further to the right, and enter your first character there, you
  4969.    can make changes to the previous string (including the first position).
  4970.  
  4971.    You may also use [Ins] and [Del] to edit FIND strings.
  4972.  
  4973.    Two other features provide a lot of flexibility for FINDing data:  the
  4974.    "global match" character and the "don't match" attribute.
  4975.  
  4976.  
  4977.    17.2 Global Match Character - [Alt+g]
  4978.  
  4979.    The global match character works like the "?" wild card in DOS.  If a FIND
  4980.    string has the global match character, that position in the string will
  4981.    match any byte.  For example, the FIND string "str?ng" will match "strxng",
  4982.    "str@ng", "str ng", etc.  The default global match character is "?".
  4983.  
  4984.    If you want to search for a string which includes the character currently
  4985.    used for global matching, you can specify any other character by pressing
  4986.    [Alt+g] and then typing the new global match character.  You may use any
  4987.    character except space for global matching.  The new global match character
  4988.    remains in effect until changed by another [Alt+g].
  4989.  
  4990.  
  4991.    17.3 "Don't Match" Attribute - [Alt+k]
  4992.  
  4993.    You may give any character in the FIND string the "don't match" (or "match
  4994.    anything BUT this") attribute.  This means that the character in that
  4995.    position in the string will match any character in the file EXCEPT the
  4996.    actual character in the string.  To give this attribute to a character,
  4997.    press [Alt+k] and then type the character.  The character will be high-
  4998.    lighted on the screen to remind you it has the "don't match" attribute.
  4999.  
  5000.    For example, if the second character in the string "xyz" were designated as
  5001.    "don't match", the string would be a successful match to "x0z", "x=z",
  5002.    etc., but would not match "xyz".
  5003.  
  5004.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 17-4
  5005.  
  5006.  
  5007.  
  5008.    If your string contains a global match character, you may designate it as
  5009.    "don't match".  In this case, that character (in that string position only)
  5010.    is no longer treated as a global match.  For example, suppose the global
  5011.    match character is "?", and you use the string "abc?" with the last
  5012.    character as "don't match".  Then EDDY would not find "abc?" if it occurred
  5013.    in the file, but it would find "abc-" or "abcd", etc.
  5014.  
  5015.    Similarly, if you designate a blank as "don't match", it will no longer
  5016.    match multiple blanks, carriage returns, line feeds or TABs.  Instead, it
  5017.    will simply be treated as a match to any single character except blank.
  5018.  
  5019.    Typing [Alt+k] again, or any ASCII character in a string position
  5020.    previously marked as "don't match" removes the "don't match" attribute.
  5021.  
  5022.  
  5023.    17.4 FIND "Any Text"
  5024.  
  5025.    You might want to search a .COM or .EXE file to see what messages might be
  5026.    lurking in it (such as "gotcha!" or "virus", for example).  Or you might
  5027.    want to see how many words in a document have more than "n" letters.
  5028.  
  5029.    You can do things like this by entering a FIND string that has only "?"s
  5030.    (or whatever global match character you are using).  If your string has
  5031.    only "?"s, it will FIND any string of upper- or lowercase LETTERS that is
  5032.    at least as long as your string.  It will also match strings containing
  5033.    spaces, as long as there are not two or more in a row.
  5034.  
  5035.    Thus, the FIND string "?????" would match:
  5036.                            "abcde", "AbcDE", or "a c e"
  5037.    but would not match:
  5038.                            "ab&de", "Ab-DE", or "a  de".
  5039.  
  5040.    You can also use the "don't match" attribute ([Alt+k]) with strings of
  5041.    "?"s.  Don't match in this case means match only if the character is NOT a
  5042.    letter ("space" is not a letter).
  5043.  
  5044.    For example, if the middle "?" in the above FIND string were given the
  5045.    "don't match" attribute, the string would match:
  5046.                            "ab&de", "Ab-DE", or "a  de"
  5047.    but would not match:
  5048.                            "abcde", "AbcDE", or "a c e".
  5049.  
  5050.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 17-5
  5051.  
  5052.  
  5053.  
  5054.    17.5 FIND String in All Files - [^f]
  5055.  
  5056.    To search through all files for the given string, press [^f].  If the
  5057.    working directory contains subdirectories, you will be asked whether you
  5058.    wish to search the files in them as well.
  5059.  
  5060.    The first file from your current display will then be displayed in LOOK
  5061.    mode, and the FIND window will be ready for you to enter the FIND string.
  5062.  
  5063.    If a match is found, the first character is highlighted in a LOOK mode
  5064.    display, as for [Alt+f] or [f].  If there is no match in that file, the
  5065.    search will proceed to the next file, continuing until there is a match or
  5066.    there are no more files.
  5067.  
  5068.    After a match, you have 4 choices:
  5069.  
  5070.         1.  Pressing [f] searches the file for any more matches, and proceeds
  5071.             to the next file if no match is found.
  5072.         2.  You can press [Alt+f] to change the FIND string, and the new
  5073.             string will used for matching from that point on.
  5074.         3.  [Esc] exits from the current file without searching further, and
  5075.             moves on to the next file.
  5076.         4.  To stop the search and return to EDIT mode, press [^c] or
  5077.             [BackSpace].
  5078.  
  5079.  
  5080.    17.6 FIND and REPLACE - [Alt+r]
  5081.  
  5082.    To replace occurrences of the FIND string with a new string (the "REPLACE
  5083.    string"), press [Alt+r].  The FIND window will be expanded to allow entry
  5084.    of a REPLACE string in the lower portion of the window.  REPLACE strings
  5085.    are entered exactly the same as FIND strings, and may be ASCII and/or hex.
  5086.  
  5087.    Switching between the two parts of the window is done with the cursor keys:
  5088.    [Up] moves from the REPLACE part to the FIND part, and [Down] moves from
  5089.    FIND to REPLACE.
  5090.  
  5091.    To shrink the window back to normal FIND-only size, press [Alt+r] again.
  5092.  
  5093.    If you begin the search with the REPLACE part of the window showing on the
  5094.    screen, then the REPLACE string will be used whenever a match is found for
  5095.    the FIND string.  When you begin the search, you will be asked whether you
  5096.    want EDDY to pause for you to confirm before replacing, or just to go ahead
  5097.    and make the replacement automatically.
  5098.  
  5099.    A FIND string may contain global match or "don't match characters, even
  5100.    when used with a REPLACE string.
  5101.  
  5102.    If the REPLACE string is shorter than the FIND string (e.g., with a "close"
  5103.    match that includes white space), the REPLACE string will be padded with
  5104.    trailing blanks as required to make the two strings the same length.  A
  5105.    REPLACE string may not be longer than its corresponding FIND string.
  5106.  
  5107.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 18-1
  5108.  
  5109.  
  5110.  
  5111.    18.  File Selection by Filtering
  5112.  
  5113.    You may choose to display only files which have particular attributes
  5114.    (e.g., read only) and/or particular timestamps (e.g., files with timestamps
  5115.    later than 9 A.M. today).  Filter values may be entered from the command
  5116.    line or while executing EDDY.  When filters are in use, they are shown in
  5117.    the top line of the display.
  5118.  
  5119.    Closely related to filters is the feature called "exclusion", which allows
  5120.    you to specify files that are NOT to be included in the display.  See
  5121.    Section 18.3.
  5122.  
  5123.    If the working directory has files that are not displayed because a filter
  5124.    is being used, an plus sign will appear just to the right of the file count
  5125.    field in the display heading (e.g., "53+files" instead of "53 files").
  5126.  
  5127.    When you set or change a filter and there are other changes pending, such
  5128.    as renaming, copying, etc., EDDY checks to be sure that all files with
  5129.    changes will still be included in the display after the new filter takes
  5130.    effect.  If not, you will be warned that some changes will be lost, and
  5131.    given a chance to decide whether to proceed or not.
  5132.  
  5133.  
  5134.    18.1 Filtering by Attribute
  5135.  
  5136.    To filter the directory display so that it contains only files with
  5137.    attributes you specify, use an attribute selection parameter.
  5138.  
  5139.  
  5140.    18.1.1 Attribute Selection from the Command Line
  5141.  
  5142.    A command line attribute selection parameter begins with a plus sign ("+")
  5143.    to distinguish it from a path specification.  The "+" is followed by one or
  5144.    more letters for the file attributes you choose.  The letters to use are
  5145.    the same as the letters in EDDY's display heading:  R, H, S, D, A or N.
  5146.  
  5147.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 18-2
  5148.  
  5149.  
  5150.  
  5151.    To select files which have the attribute ON, enter the letter in upper
  5152.    case; for files with the attribute OFF, lower case.  Thus, to select only
  5153.    files which are "hidden", enter "+H"; for files which are read-only and not
  5154.    modified since last backup (i.e., "archive" attribute off), enter "+Ra" or
  5155.    "+aR" (the order makes no difference).  If more than one attribute is
  5156.    selected, all must match in order for a file to be selected.
  5157.  
  5158.    If you specify an incorrect letter, or use the same letter in both upper
  5159.    and lower case, EDDY will terminate with an "Invalid format" error message.
  5160.  
  5161.    Attribute selections are shown in the display heading.  The letters for the
  5162.    selected attributes will blink, showing they're used for file selection,
  5163.    and they will be the same case -- upper or lower -- as you specified.
  5164.  
  5165.  
  5166. |  18.1.2 Attribute Selection in EDDY - [Alt+a]
  5167.  
  5168.    Press [Alt+a] for attribute selection while executing EDDY, then enter the
  5169.    attributes to be used for filtering.  [Esc] restores the attribute filter
  5170.    previously in effect, if any.
  5171.  
  5172.    To select an attribute, press the key for the corresponding letter -- [R],
  5173.    [H], [S], [D], [A] or [N].  Pressing a key once selects "attribute ON",
  5174.    twice selects "attribute OFF", and a third time deselects the attribute.
  5175.    When you are satisfied with the selection, press [Enter].
  5176.  
  5177.    Or select attributes by moving the cursor to an attribute and clicking the
  5178.    mouse or pressing [SpaceBar].
  5179.  
  5180.  
  5181.    18.2 Filtering by Timestamp
  5182.  
  5183.    To filter the directory display so that it contains only files with
  5184.    timestamps in a range you specify, use timestamp selection.
  5185.  
  5186.  
  5187.    18.2.1 Timestamp Selection from the Command Line
  5188.  
  5189.    A command line timestamp selection parameter is enclosed in double quote
  5190.    marks.  Immediately following the first quote must be one of the following:
  5191. |  "+", "-" or "=".  These mean that the files to be selected for display must
  5192.    have timestamps greater than, less than, or equal to the timestamp you use.
  5193.  
  5194.    Next, you must provide the timestamp value.  This may be a date, a time, or
  5195.    both.  Following the timestamp value is the closing quote mark.
  5196.  
  5197.    Leading zeros must be used when entering dates if needed to make up a two-
  5198.    digit value -- e.g., "5/31/88" would be rejected; "05/31/88" would be O.K.
  5199.  
  5200.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 18-3
  5201.  
  5202.  
  5203.  
  5204.    Times are based on a 12-hour clock, and must be in the form "hh:mma" for
  5205.    A.M. times, or "hh:mmp" for P.M.  Again, leading zeros are required.
  5206.  
  5207.    If you wish to specify both date and time, the date and time must be
  5208.    separated by one space.
  5209.  
  5210.    Some examples of valid timestamp values are:
  5211.  
  5212. |   "+05/31/88 09:00p" - select files with timestamps later than this
  5213.  
  5214. |   "=07/23/86" - select files created at any time on this date only
  5215.  
  5216.     "-10:30p" - select files created before this time, on any date
  5217.  
  5218.    Normally, EDDY will re-sort the display when you use timestamp filtering.
  5219.    When the filter includes a date, the display will be sorted by date.  If
  5220.    the filter has only a time, it will be sorted by time.
  5221.  
  5222.    However, if you have explicitly changed the display sequence (by using
  5223.    option /1 or one of the sort commands), then filtering by timestamp will
  5224.    not cause a re-sort.
  5225.  
  5226.  
  5227. |  18.2.2 Timestamp Selection in EDDY - [Alt+q]
  5228.  
  5229. |  Press [Alt+q] for timestamp selection.  Any timestamp filter in effect at
  5230.    that time will be cancelled, the null timestamp "=00-00-00 00:00p" will
  5231.    appear in the top line, and the cursor will move to the "=" sign.  If you
  5232.    don't want to enter a new timestamp value, press [Enter] while the null
  5233.    timestamp is displayed, and no timestamp filter will be used.
  5234.  
  5235.    Otherwise, the null timestamp may be edited just as though it was a normal
  5236.    file timestamp in the body of the display.  When you are happy with the
  5237.    filter value, press [Enter].  If you enter an invalid timestamp, EDDY will
  5238.    "beep" at you and move the cursor to the field in error.
  5239.  
  5240.  
  5241.    18.3 Exclusion - [*]
  5242.  
  5243.    Normally, if you append a file specification (including wildcards) to your
  5244.    working directory path, any files that match that specification will be
  5245.    included in your display, and all others will be excluded.
  5246.  
  5247.    You may reverse this logic if you wish.  Press [*] to turn on the exclusion
  5248.    feature; i.e., exclude all files that match, and include only those that
  5249.    DON'T match.  Exclusion doesn't have any effect if your file specification
  5250. |  is set to "*.*" (unless you also have an attribute and/or timestamp filter
  5251. |  in effect, as described below).  If exclusion is on and you change your
  5252. |  file specification to "*.*" (and no filters used), it will be turned off.
  5253.  
  5254.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 18-4
  5255.  
  5256.  
  5257.  
  5258.    When exclusion is turned on, the file specification on the "DIR of" line of
  5259. |  the display will be emphasized by reverse video.
  5260.  
  5261.    Exclusion is applied before any attribute or timestamp filtering.  First, a
  5262.    file becomes a candidate for display depending on its name as compared with
  5263.    your file specification.  Next, if exclusion is on, candidates are
  5264. |  discarded and non-candidates become candidates -- EXCEPT, if the file
  5265. |  specification is "*.*" and there is a filter in use, nothing is discarded
  5266. |  at this point.  Finally, any filtering in effect is applied to the
  5267.    candidate.  If a file is still a candidate after these steps, it is
  5268.    included in the display.
  5269.  
  5270.    [*] is a toggle; pressing it a second time turns exclusion off.
  5271.  
  5272.    If you use the exclusion feature, be prepared for an occasional delay while
  5273.    EDDY builds the display.  To determine which files to include, ALL files'
  5274.    directory entries must be read, and a byte-by-byte check made to see
  5275.    whether their names match the given file specification.
  5276.  
  5277.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 19-1
  5278.  
  5279.  
  5280.  
  5281.    19.  Playing With RAM
  5282.  
  5283.    You may access your PC's main memory from EDDY, in much the same way as for
  5284.    files.  If option /R is turned ON, the display will include an entry with
  5285.    the name " memory", showing the no. of bytes of RAM in your system (as
  5286.    indicated by your system's BIOS), and the current DOS date and time.
  5287.  
  5288.    This entry will appear at the end of the list of files in most displays,
  5289.    with two exceptions:  if the sort sequence is inverted, the " memory" entry
  5290.    will be at the top; and if there are more files in the directory than EDDY
  5291.    can display at once, the " memory" entry will not appear at all.
  5292.  
  5293.    " memory" is not included in the display of number of files and bytes used.
  5294.  
  5295.    You may LOOK at, FIND strings in, or PATCH the " memory" entry.  For more
  5296.    information on these, see the respective sections of this document.
  5297.  
  5298.    Pressing [F5] while the cursor is on the " memory" entry tags RAM for
  5299.    COPYing.  When you UPDATE, the RAM data will be dumped into a file named
  5300.    "-MEMORY-.@@@" (in the target).  If such a file already exists, it will be
  5301.    overwritten.  The file will be as large as your PC's memory, so on floppy-
  5302.    only systems you probably won't have enough room.
  5303.  
  5304.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 20-1
  5305.  
  5306.  
  5307.  
  5308.    20.  Volume Identifiers
  5309.  
  5310.    DOS offers two methods of identifying disks:  volume labels and volume
  5311.    serial numbers.  EDDY provides services for both.
  5312.  
  5313.  
  5314.    20.1 Volume Labels - [Alt+v] / [Alt+Shift+v]
  5315.  
  5316.    To create or change a volume label on a disk, press [Alt+v].  Then type the
  5317.    new label in the dialog box on the screen, and [Enter].
  5318.  
  5319.    Labels may contain ANY characters you like, with one exception:  the first
  5320.    byte may not be 05 (hex).  You may even enter a label of all blanks, if you
  5321.    want, or labels containing characters such as ":", "\" and ".".
  5322.  
  5323. |  There is a price for all this flexibility:  a lot of non-standard gyrations
  5324. |  are required, and these take extra time.  This is particularly noticeable
  5325. |  on diskettes, where the label update can take over 10 seconds to complete.
  5326. |  But it DOES allow you to be as creative as DOS's 11 bytes will allow.
  5327.  
  5328.    When creating a new label for an unlabelled disk, you'll get an error if
  5329.    the disk's root directory already has the maximum number of entries (e.g.,
  5330.    112 for a DSDD 5-1/4" floppy) allowed by DOS.
  5331.  
  5332.    To delete an existing label, press [Alt+Shift+v].
  5333.  
  5334.  
  5335.    20.2 Volume Serial Numbers - [^v]
  5336.  
  5337.    To create or change a volume serial number on a disk, press [^v].  Then
  5338.    type the new serial number in the dialog box on the screen, and [Enter].
  5339.  
  5340.    The serial number consists of 8 hexadecimal digits ("0" - "9", "A" - "F").
  5341.    There is also a hyphen displayed, but this is only for readability.  The
  5342.    hyphen is not part of the serial number.
  5343.  
  5344.    Not all disks have volume serial numbers -- specifically, those formatted
  5345.    with a version of DOS earlier than 4.0, and some non-standard device-driven
  5346.    disks, such as some RAM disks and compressed disks.  If you use [^v] on one
  5347.    of these, EDDY will complain.
  5348.  
  5349.    If you wish, you may PATCH 4 bytes in the boot sector, starting at offset
  5350.    00000027h, with a serial number of your choice.  If you want DOS to
  5351.    recognize it (e.g., with the "DIR" command) then you must also PATCH the
  5352.    byte at 00000026h to contain "29h"; this is a flag that tells DOS the boot
  5353.    sector contains a serial number, and other data normally included only with
  5354.    disks formatted by DOS 4 and later versions.
  5355.  
  5356.    On most disks formatted by earlier versions, the serial number field
  5357.    contains all zeros anyway, and there's no problem.  Some however, have
  5358.    other values for these bytes, and the meaning (or lack thereof) is unknown.
  5359.    Patch at your own risk!
  5360.  
  5361.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 21-1
  5362.  
  5363.  
  5364.  
  5365.    21. Printing
  5366.  
  5367.    By default, EDDY will print to the device on LPT1 -- normally, a printer
  5368.    connected to a parallel port.  If your printer setup is different, you may
  5369.    customize EDDY to use the correct device name instead, using the "port"
  5370.    configuration parameter in EDDY.INI.  See Section 30.3.2d for details.
  5371.  
  5372.  
  5373.    21.1  Print a Copy of What's Displayed - [Alt+p] / [^p]
  5374.  
  5375.    EDDY's displays may be printed, by pressing [Alt+p].  The basic, EDIT mode
  5376.    directory display, the LOOK mode file display (in either hex or text
  5377.    format), and the list of files and actions involved in an UPDATE may all
  5378.    be printed if you wish.
  5379.  
  5380.    If you would prefer to send the print-formatted output to a file, press
  5381.    [^p] instead of [Alt+p].  If you choose to "print" to a file, you will be
  5382.    asked to specify the filename to be used (the default is "EDDY.PRN").  If
  5383.    the file already exists in the working directory, you may choose either to
  5384.    append the new data to it or overwrite it.
  5385.  
  5386.    When printing, EDDY tries to ensure that characters that may be interpreted
  5387.    as control strings by the printer are not sent to the printer.  It does
  5388.    this in a very simple-minded way, which is explained in Section 8.2.5a.  If
  5389.    you send the output to a file, however, this is not a problem; EDDY sends
  5390.    the bytes "as-is" (as-are?) to the file, with one exception -- any "^Z"s
  5391.    will be written as spaces.
  5392.  
  5393.    In EDIT and LOOK modes, pressing any key during the printing will stop the
  5394.    printing operation.  In UPDATE mode, you can turn printing off by pressing
  5395.    [Alt+p] or [^p] again.  Pressing any other key suspends the UPDATE process.
  5396.  
  5397.  
  5398.    21.2  Printer Control
  5399.  
  5400.    There are thousands of variations of printer commands, which differ by
  5401.    manufacturer and model.  Except for the most basic commands (advancing a
  5402.    line or ejecting a page), you'll have to do a little research to find out
  5403.    what your printer uses.  Once you have this information, you can put it
  5404. |  into the EDDY.USE file (see Section 14.3), from where you can change your
  5405.    printer setup easily from then on.
  5406.  
  5407.  
  5408.    a.  Formfeed / Linefeed - [Alt+0] / [Alt+1]
  5409.  
  5410.    A couple of simple, virtually universal, printer commands are defined in
  5411.    EDDY.  For anything more complex, see the next section.
  5412.  
  5413.    Available commands (in EDIT and LOOK modes), and their hot keys, are:
  5414.  
  5415.    - Send formfeed (page eject)          [Alt+0]
  5416.    - Send linefeed (advance 1 line)      [Alt+1]
  5417.  
  5418.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 21-2
  5419.  
  5420.  
  5421.  
  5422.    b.  Printer Commands in EDDY.USE - [Alt+9]
  5423.  
  5424.    Any commands that you want to use with your printer -- for example, to
  5425.    change the type pitch (characters per inch) -- may be defined in a file
  5426.    called "EDDY.USE".
  5427.  
  5428.    A sample EDDY.USE is part of the EDDY distribution package.  This sample
  5429.    includes extensive explanatory comments, and I hope it will suggest ways in
  5430.    which EDDY can help your system be easier and more convenient to use.
  5431.  
  5432.    The details of the format used to specify printer control strings in
  5433. |  EDDY.USE are provided in Section 14.3.
  5434.  
  5435.    To make use of the printer commands in EDDY.USE, press [Alt+9] and follow
  5436.    the directions displayed on the screen.
  5437.  
  5438.    EDDY.USE may also contain "Point & Shoot" commands; their use is explained
  5439.    in Section 14.1.
  5440.  
  5441.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 22-1
  5442.  
  5443.  
  5444.  
  5445. |  22. List Files - [Alt+l] / [^l]  (that's an "L", not a "ONE")
  5446. |
  5447. |  List files are ASCII text files containing filenames, one per line, with or
  5448. |  without path specifications.  They may be used as input to other programs,
  5449. |  such as PKZIP, to tell those programs what files to operate on.  They may
  5450. |  be edited into "response" files used by programs such as Borland's TLINK,
  5451. |  or edited (for example, into batch files) and used for any other purpose.
  5452. |
  5453. |
  5454. |  22.1  Single-directory List Files - [Alt+l]
  5455. |
  5456. |  To write information to a list file from the working directory, press
  5457. |  [Alt+l].
  5458. |
  5459. |  The default name for a list file is EDDY.LST; you may choose another name
  5460. |  if you prefer.  If a file already exists with the same name, you will be
  5461. |  asked whether the file should be overwritten or whether the new data should
  5462. |  be appended to the existing file.
  5463. |
  5464. |  The list file will be created in the working directory, UNLESS the working
  5465. |  directory is on a write-protected disk or other read-only medium, such as a
  5466. |  CD-ROM.  In this case, you'll be given the choice of putting the list file
  5467. |  in the target directory instead.
  5468. |
  5469. |  You have several ways of controlling exactly what is written to a list
  5470. |  file:
  5471. |
  5472. |    - You will be given a choice of including the working directory path with
  5473. |      each filename wriiten to the list file, or not.
  5474. |
  5475. |    - You will also be asked whether or not you want to include the names of
  5476. |      subdirectories of the working directory.  Subdirectory names written to
  5477. |      the list file end with a "\", so they are easy to distinguish from file
  5478. |      names.
  5479. |
  5480. |    - If there are filenames you don't want to include in the list file, tag
  5481. |      those files as "Ignore" -- by pressing [Alt+F7] -- before pressing
  5482. |      [Alt+l].
  5483. |
  5484. |  If you decide to add more to a list file, just press [Alt+l] again, anytime
  5485. |  you are working in that same directory.  You'll have a choice of appending
  5486. |  more entries to what's already there, or starting entirely anew.  Also,
  5487. |  since you have complete control over the filename used with each press of
  5488. |  [Alt+l], you may have multiple list files in the same directory.
  5489. |
  5490. |  Except as explained in the next section, a list file will be closed when
  5491. |  you change to a new working directory, and pressing [Alt+l] in the new
  5492. |  directory will create a new list file there.
  5493.  
  5494.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 22-2
  5495.  
  5496.  
  5497.  
  5498. |  22.2  "Persistent" List Files - [^l]
  5499. |
  5500. |  When you want to create a "persistent" list file -- i.e., one that remains
  5501. |  open until you explicitly close it, rather than being closed when you
  5502. |  change to a new working directory -- start the process by pressing [^l].
  5503. |
  5504. |  [^l] is a toggle, opening a new persistent list file or closing an existing
  5505. |  one.  No data is actually written to the list file until you press [Alt+l].
  5506. |
  5507. |  After a persistent list file has been created, but before any data has been
  5508. |  written to it, you'll see its entry in the working directory, with a file
  5509. |  size of zero; that's normal, and is not a problem.
  5510. |
  5511. |  When a persistent list file is open, you may add data to it from any
  5512. |  directory by pressing [Alt+l].  EDDY will remind you that a persistent list
  5513. |  file has already been created, and ask whether you want to add to it.  You
  5514. |  may choose to create a new, single-directory list file at this time if you
  5515. |  wish.  If you do this, the persistent list file will remain open
  5516. |
  5517. |  If you press [Alt+l] when you are in a directory that you reached by doing
  5518. |  a "Where's That File" search (see Section 5.7), and there is a persistent
  5519. |  list file open, the data from that directory is written to the list file
  5520. |  without further query.  This is useful for building lists of files that you
  5521. |  want to operate on in the same way, but which are in different directories.
  5522. |
  5523. |  For example, you might search for all "*.BAK" files, in all directories
  5524. |  (using [^w]) and build a complete list of them, including full pathnames.
  5525. |  Then you could edit the list file to include "del " at the start of each
  5526. |  line, and use the result as a batch file to clean up your disk.  (Although,
  5527. |  in this example, it would be easier just to use EDDY's "Delete" command on
  5528. |  those files, when they are displayed after the [^w]).
  5529. |
  5530. |  If you use [^l] when there is an existing persistent list file, you will
  5531. |  be given the choice of closing the current list file or not.  If you choose
  5532. |  not to close it, any subsequent [Alt+l] continues to add to the old one.
  5533.  
  5534.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 23-1
  5535.  
  5536.  
  5537.  
  5538.    23. Tracking Directory Changes with "Snapshots"
  5539.  
  5540.    Some reasons for keeping track of changes to your directories:
  5541.  
  5542.    - When installing a new software package (especially under Windows!), it's
  5543.      usually VERY hard to identify all the files that have been added or
  5544.      modified by the installation process.  Of course, that makes it difficult
  5545.      if you decide you want to uninstall the package later; you don't know for
  5546.      sure which files are safe to remove.
  5547.  
  5548.    - If you share access to files with others, it's often useful to know what
  5549.      files the "others" may have messed with.
  5550.  
  5551.    - Being able to tell which files have been changed after running a program
  5552.      gives you a way to detect many virus infections.
  5553.  
  5554.    EDDY offers a simple mechanism to allow you to keep track of changes.  You
  5555.    can take a directory "snapshot", which records the working directory data
  5556.    in a file, and you can compare a previously-taken snapshot with the current
  5557.    working directory data.
  5558.  
  5559.    Snapshot processing may be interrupted, as described in Section 23.3.
  5560.  
  5561.  
  5562.    23.1 Take Snapshot - [Shift+F5]
  5563.  
  5564.    With the cursor on either the "DIR of..." line (top line of display), or on
  5565.    the "." line if the display is for a subdirectory, press [Shift+F5] to take
  5566.    a "snapshot".
  5567.  
  5568.    If the working directory contains subdirectories, you will be given a
  5569.    choice of "snapping" the entire subtree (from the working directory down),
  5570.    or snapping just the working directory.
  5571.  
  5572.    Choosing to snap the entire subtree while in the root directory allows you
  5573.    to easily and precisely track changes that may occur anywhere on your disk.
  5574.  
  5575.  
  5576.    23.1.1 Snap Working Directory Only
  5577.  
  5578.    The directory information for ALL files and subdirectories (except the "."
  5579.    and ".." entries), hidden or otherwise, displayed or not, will be recorded
  5580.    in a file named SNAPSHOT.{.} (Actually, the extension is a hex 0F9 enclosed
  5581.    in brackets, but that won't print properly on many printers, and it looks
  5582.    pretty much like a ".", anyway).
  5583.  
  5584.    There is an exception to the above statement: SNAPSHOT.{.}'s directory
  5585.    data will NOT be included in the snapshot.  Also, SNAPSHOT.{.} will not be
  5586.    automatically included in any of the "repeated" command processing; e.g.
  5587.    it would not be tagged for COPY if you press [^F5], nor DELETE if [^F7].
  5588.  
  5589.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 23-2
  5590.  
  5591.  
  5592.  
  5593.    A Cyclic Redundancy Check (CRC) will be computed and stored for all files
  5594.    (but not subdirectories), so that changes to the files' contents may be
  5595.    detected later.  If you have really big files, such as DoubleSpace or
  5596.    Stacker compressed volumes, the calculation can take a loonnngggg time!
  5597.    Therefore, when calculating CRCs for files larger than a couple of
  5598.    megabytes, EDDY displays the filename, and allows you to interrupt the
  5599.    calculation for that file by pressing [^c].
  5600.  
  5601.    If you interrupt, then no comparison can be done later on the CRC for that
  5602.    file -- it will always be considered to have no change in CRC until you
  5603.    later take a snapshot and allow the calculation to complete.  For
  5604.    compressed disks, there's probably not much point in calculating a CRC
  5605.    anyway, as these files normally change every time you use your system.
  5606.  
  5607.  
  5608.    23.1.2 Snap Working Directory Subtree
  5609.  
  5610.    If you choose to include all subdirectories of the working directory in the
  5611.    snap process, a separate SNAPSHOT.{.} file will be created in each of those
  5612.    subdirectories.  This works just as described above, for each directory in
  5613.    the subtree.
  5614.  
  5615.    The status line at the bottom of the screen will tell you which directory
  5616.    is currently being snapped ("Analyzing...").  This may occasionally be
  5617.    changed to identify large files as their CRCs are being calculated, as
  5618.    described above.  If you press [^c] while one of these filenames is being
  5619.    displayed, the CRC calculation will be skipped, just as when snapping
  5620.    single directories.
  5621.  
  5622.  
  5623.    23.2 Compare Directories with Snapshots - [Shift+F3]
  5624.  
  5625.    If the cursor is on the "DIR of..." line or the "." line, pressing
  5626.    [Shift+F3] causes EDDY to compare the contents of the snapshot file with
  5627.    the current working directory data.
  5628.  
  5629.    If the working directory contains subdirectories, you will be given a
  5630.    choice of comparing snapshots and directories in the entire subtree (from
  5631.    the working directory down), or just the working directory and its
  5632.    SNAPSHOT.{.} file.
  5633.  
  5634.    In addition to the material below, another way to use the snapshot feature
  5635.    for comparing directories is described in Section 8.7.
  5636.  
  5637.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 23-3
  5638.  
  5639.  
  5640.  
  5641.    23.2.1  Working Directory Snapshot Comparison
  5642.  
  5643.    If no differences are found, you will see a message to that effect.  If
  5644.    there are differences, you will see a screen (the "DELTA Summary) showing
  5645.    the differences found, by category.  The categories are:
  5646.  
  5647.       1. In DIR, not in Snapshot
  5648.  
  5649.       2. In Snapshot, not in DIR
  5650.  
  5651.       3. Timestamp newer than Snapshot
  5652.  
  5653.       4. Timestamp older than Snapshot
  5654.  
  5655.       5. Same except for attributes
  5656.  
  5657.       6. Same timestamp, different size
  5658.  
  5659.       7. No change since Snapshot taken
  5660.  
  5661.       8. Same size, different CRCs
  5662.  
  5663.    A file will be counted only under one of categories 1 - 7.  For files which
  5664.    are still the same size as recorded in the snapshot, and are in categories
  5665.    3, 4 or 5, the CRC is recomputed and compared with the value stored in the
  5666.    snapshot.  Any differences are counted under category 8, AND under category
  5667.    3, 4 or 5 as appropriate.  Thus, the total count may be greater than the
  5668.    number of files in the directory.
  5669.  
  5670.    For each category with a non-zero count, you may view the list of files in
  5671.    that category.  Categories 3 - 6 will show both the snapshot data and the
  5672.    working directory information, for easy comparison.  The display is in the
  5673.    order that the directory entries are physically stored on the disk.
  5674.  
  5675.    If the directory sequence is different from when the snapshot was taken,
  5676.                        "NOTE - Directory sequence changed"
  5677.    will be displayed as the last line of the summary.
  5678.  
  5679.    As when the snapshot was taken, you may interrupt the CRC comparison
  5680.    process for big files if you don't want to wait for the calculation to
  5681.    complete.  If you do interrupt, the CRC for that file will be treated as
  5682.    though it is identical to the CRC previously stored in the snapshot file,
  5683.    regardless of its actual value.
  5684.  
  5685.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 23-4
  5686.  
  5687.  
  5688.  
  5689.    23.2.2  Subtree Snapshot Comparisons
  5690.  
  5691.    If you choose to compare snapshots and directories throughout a subtree,
  5692.    the operation for each directory is similar to the description in the
  5693.    preceding section.
  5694.  
  5695.    The primary difference is that if a subdirectory has no changes from its
  5696.    snapshot (or no snapshot is present), no display will be generated for that
  5697.    directory, and processing will continue immediately to the next directory
  5698.    in the subtree when you finish looking at the display of differences.
  5699.  
  5700.  
  5701.    23.3 Interrupting Snapshot Processing - [^c]
  5702.  
  5703.    Taking and comparing snapshots can take quite a while, as every byte in
  5704.    every file must be examined.  In case you get impatient, you may press [^c]
  5705.    at any point in the process.
  5706.  
  5707.    If you interrupt the process while snapshots are being created for all the
  5708.    directories in a subtree, any SNAPSHOT.{.} files created up to that point
  5709.    will be left intact.
  5710.  
  5711.    If you press [^c], you will normally be given a choice whether just to
  5712.    bypass processing for the current directory, or cancel the snapshot process
  5713.    entirely.  An exception is if you press [^c] while the CRC of a big file
  5714.    ("big" means > 2MB) is being calculated.  In that case, only the CRC
  5715.    calculation for that file is interrupted, as described above.
  5716.  
  5717.  
  5718.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 24-1
  5719.  
  5720.  
  5721.  
  5722.    24. Disk Jockey's Delight  (format-level disk functions)
  5723.  
  5724.    These functions are not available when looking at remote (network) drives.
  5725.  
  5726.  
  5727.    24.1  "Compressed" or "Extended" Drives (CVFs: Stacker, etc.)
  5728.  
  5729.    EDDY can do things to your disks that you probably shouldn't do if using
  5730.    disk capacity expansion utilities such as DoubleSpace, Stacker, SuperStor,
  5731.    or similar products.  For example, shuffling directories and and patching
  5732.    disk sectors have the potential to cause serious problems (i.e., your data
  5733.    may disappear!) if you're not completely certain of what you're doing.
  5734.  
  5735.    BACK UP YOUR DATA BEFORE EXPERIMENTING!
  5736.  
  5737.    Therefore, EDDY tries to identify such drives before proceeding with any of
  5738.    these functions.  If a drive is identified as being one of these, you will
  5739.    either be warned and asked for confirmation before EDDY proceeds, or the
  5740.    function will simply be rejected, depending upon what you're trying to do.
  5741.  
  5742. |  For "drives" that are recognized by EDDY -- either automatically or as
  5743. |  identified by the user -- as being "compressed volume files" (CVFs), the
  5744. |  third line of the first screen will show "[CVF]" instead of "Drive".
  5745.  
  5746.    The first time one of these functions is requested on a drive, if EDDY
  5747.    can't decide automatically whether it's a real drive or a CVF (some vendors
  5748.    provide information on how to detect their products, and some don't) you
  5749.    will be asked...
  5750.          Is <x:> a "compressed drive" - DoubleSpace, Stacker, etc (y/n)?
  5751.    ...and EDDY will treat that drive according to your answer for the rest of
  5752.    that session.  If you customize, the information as to which drives are
  5753.    CVFs will be recorded permanently.
  5754.  
  5755.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 24-2
  5756.  
  5757.  
  5758.  
  5759.    24.2 LOOK at Entire Disk - [F3]
  5760.  
  5761.    If you press [F3] on the third line of the display ("Drive X:  is..."), you
  5762.    will enter LOOK mode for the entire disk, without regard to any file or
  5763.    directory structure.  In effect, the whole disk is treated as a single
  5764.    file.  The display will begin with the sector on the disk where the working
  5765.    directory is located.
  5766.  
  5767.    When LOOKing at the disk, the display is always in hex.  However the
  5768.    meaning of "Offset" is different; "Offset" specifies physical disk sectors
  5769.    (normally 512 bytes each).  Here's an example of this type of display:
  5770.  
  5771. ================================================================================
  5772.  Offset    00 01 02 03 04 05 06 07-08 09 0A 0B 0C 0D 0E 0F          ASCII     P
  5773.  
  5774.      1B0   6F 6E 73 AC 20 77 68 69 63 E8 20 61 72 E5 20 A0 ??? ons, which are
  5775.      1C0   63 6F 6D 70 75 74 65 E4 20 A0 61 75 74 6F 6D 61 ??? computed  automa
  5776.      1D0   74 69 63 61 6C 6C F9 20 8D 0A A0 A0 A0 A0 A0 A0 ??? tically ..
  5777.      1E0   A0 A0 A0 77 68 65 EE 20 65 6E 74 65 72 65 64 AE ???    when entered.
  5778.      1F0   20 20 49 EE 20 63 61 73 65 F3 20 77 68 65 72 E5 ???   In cases where
  5779. 0000193F   20 74 68 E5 20 64 69 6D 65 6E 73 69 6F 6E 61 EC      the dimensional
  5780. 0633 010   20 77 65 69 67 68 F4 20 A0 69 F3 20 8D 0A A0 A0      weight  is ..
  5781.      020   A0 A0 A0 A0 A0 A0 A0 67 72 65 61 74 65 F2 20 74            greater t
  5782.      030   68 61 EE 20 74 68 E5 20 61 63 74 75 61 EC 20 77     han the actual w
  5783.      040   65 69 67 68 74 AC 20 74 68 E5 20 53 79 73 74 65     eight, the Syste
  5784.      050   ED 20 61 75 74 6F 6D 61 74 69 63 61 6C 6C F9 20     m automatically
  5785.      060   8D 0A A0 A0 A0 A0 A0 A0 A0 A0 A0 E3 61 6C 63 75     ..         calcu
  5786.      070   6C 61 74 65 F3 20 64 69 6D 65 6E 73 69 6F 6E 61     lates dimensiona
  5787.      080   EC 20 77 65 69 67 68 F4 20 63 68 61 72 67 65 73     l weight charges
  5788.      090   2E 0D 0A 2E 70 61 0D 7d A0 A0 A0 A0 A0 A0 46 72     ....pa..      Fr
  5789.      0A0   6F ED 20 A0 69 6E 66 6F 72 6D 61 74 69 6F EE 20     om  information
  5790.      0B0   A0 65 6E 74 65 72 65 64 AC 20 74 68 E5 20 53 79      entered, the Sy
  5791.      0C0   73 74 65 ED 20 63 72 65 61 74 65 F3 20 A0 E1 20     stem creates  a
  5792.      0D0   A0 64 65 74 61 69 6C 65 E4 20 8D 0A A0 A0 A0 A0      detailed ..
  5793.      0E0   A0 A0 68 69 73 74 6F 72 F9 20 A0 6F E6 20 65 61       history  of ea
  5794.      0F0   63 E8 20 73 68 69 70 6D 65 6E F4 20 72 65 63 6F     ch shipment reco
  5795.  
  5796. -LOOK-   Drive C:\     bits=8  tab=8  line= ?      [F1]:HELP       [Alt+F1]:MENU
  5797. ================================================================================
  5798.  
  5799.                                    Figure 24-1
  5800.  
  5801.    The first line of each sector's display has the logical sector number in
  5802.    the "Offset" field (0000193F in the example).  The other lines for the
  5803.    indicate the offset of the bytes from the beginning of the sector.
  5804.  
  5805.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 24-3
  5806.  
  5807.  
  5808.  
  5809.    If the sector is the first sector of a cluster, the second line also shows
  5810.    the cluster number (0633 in the example).  Numbering starts with cluster 2,
  5811.    which begins with the first sector in the disk's data area.  Sectors in the
  5812.    DOS disk control area, which include the boot sector(s), File Allocation
  5813.    Table(s), root directory, etc., do not have cluster numbers.
  5814.  
  5815.    However, the starting sectors of the root directory and File Allocation
  5816.    Table(s) have "ROOT" and "FAT" respectively, under the sector number.
  5817.  
  5818.    You may notice the "???" strings in the first few lines of Figure 24-1;
  5819.    this is the way EDDY indicates sectors on which DOS has reported that an
  5820.    error has occurred while reading the data.  The data may not be accurate.
  5821.  
  5822.  
  5823.    24.2.1 Jumping Around
  5824.  
  5825.    Several "shortcut" methods are available to move the display quickly to
  5826.    various parts of the disk:
  5827.  
  5828.  
  5829.    a. Jump to Sector - [j]
  5830.  
  5831.    To move to a particular sector, press [j].  EDDY will ask you to enter the
  5832.    sector number, in hex.  When you have done so, the display will move
  5833.    accordingly.  If the number entered is larger than the last sector number
  5834.    on the disk, the last sector will be displayed.
  5835.  
  5836.  
  5837.    b. Jump to Cluster - [Alt+j]
  5838.  
  5839.    To move to a particular cluster, press [Alt+j].  EDDY will ask you to enter
  5840.    the cluster number, in hex.  When you have done so, the display will move
  5841.    accordingly.  If the number entered is larger than the last cluster number
  5842.    on the disk, the last cluster will be displayed.
  5843.  
  5844.  
  5845.    c. Jump to Working Directory - [Alt+w]
  5846.  
  5847.    Pressing [Alt+w] moves you to the first cluster of the working directory.
  5848.    (This is automatic when you LOOK at disk, but can also be used any time.)
  5849.  
  5850.  
  5851.    d. Jump to Target Directory - [Alt+t]
  5852.  
  5853.    If there is a target directory, and it is on the same disk as the working
  5854.    directory, it will be displayed if you press [Alt+t].
  5855.  
  5856.  
  5857.    e. Jump to Starting Cluster - [Alt+s]
  5858.  
  5859.    A directory entry contains a pointer (cluster number) to the first disk
  5860.    area allocated to that file or directory.  This pointer remains in the
  5861.    entry even after the file has been deleted, until that entry is used again.
  5862.  
  5863.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 24-4
  5864.  
  5865.  
  5866.  
  5867.    To look at the data on the disk at the logical start of the area allocated
  5868.    to a file or directory (the cluster), position the directory entry on the
  5869.    first line of the screen and press [Alt+s].
  5870.  
  5871.  
  5872.    f. Jump to Next Cluster - [Alt+n]
  5873.  
  5874.    Space on the disk is allocated in clusters, and the record of space alloca-
  5875.    ted is maintained in "chains" of cluster numbers, in the FAT.  To view the
  5876.    data in the next cluster in the chain for a file, press [Alt+n].
  5877.  
  5878.  
  5879.    g. Jump to Unallocated Cluster - [Alt+u]
  5880.  
  5881.    When [Alt+u] is pressed after entry to LOOK, the first cluster that has not
  5882.    been allocated is displayed.  After that, [Alt+u] displays the next
  5883.    sequential unallocated cluster.  When all unallocated clusters have been
  5884.    displayed, there's a "beep" and the display returns to the first one.
  5885.  
  5886.  
  5887.    h. Jump to "Bad Spot" - [Alt+b]
  5888.  
  5889.    When [Alt+b] is pressed after entry to LOOK, the first cluster that was
  5890.    marked as "bad" by the disk formatting process (or other utility) is
  5891.    displayed.  After that, [Alt+b] displays the next sequential "bad" cluster.
  5892.    When all "bad" clusters have been displayed, there's a "beep" and the
  5893.    display returns to the first one.
  5894.  
  5895.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 24-5
  5896.  
  5897.  
  5898.  
  5899.    24.2.2 Displaying Directory Entries - [Alt+d]
  5900.  
  5901.    If you have a directory entry displayed at the top of the screen, such as
  5902.    would be the case after an [Alt+w] or [Alt+t] command, described above, you
  5903.    can use [Alt+d].  The result will be a display (nearly) like EDDY's EDIT
  5904.    mode format for that entry.  An example is given in Figure 24-2.
  5905.  
  5906.    The attributes are shown by the letters "N_ADVSHR".  These stand for:
  5907.    Network-shareable, (system device), Archive, Directory, Volume, System,
  5908.    Hidden, and Read only, respectively.  They are listed in the same order as
  5909.    the corresponding bits of the directory entry's attribute byte.  The
  5910.    "system device" bit should never be on, and will normally be shown as "_";
  5911.    if it IS on for some reason, it will appear as a "+".  An upper case letter
  5912.    means attribute ON, lower case means OFF.
  5913.  
  5914.    The "cluster" number is the starting cluster which is (or was, if the entry
  5915.    has been deleted) allocated to the file or subdirectory.
  5916.  
  5917.    After displaying a directory entry, any keypress will clear it.  If the key
  5918.    used is also a valid command, it will be executed (e.g., if you press
  5919.    [Alt+s], the starting cluster will be displayed).
  5920.  
  5921. ================================================================================
  5922.  Offset    00 01 02 03 04 05 06 07-08 09 0A 0B 0C 0D 0E 0F          ASCII     P
  5923.  
  5924. 00000053   49 42 4D 42 49 4F 20 20 43 4F 4D 27 00 00 00 00     IBMBIO  COM'....
  5925. ROOT 010   00 00 00 00 00 00 01 48 CA 10 02 00 DF 4D 00 00     .......HJ..._M..
  5926. |------------------------------------------------------------------------------+
  5927. |        IBMBIO  .COM     19935  6-10-88  9:00:02a n_AdvSHR, cluster=0002      |
  5928. |------------------------------------------------------------------------------+
  5929.      050   00 00 00 00 00 00 01 48 30 11 1B 00 1C 63 00 00     .......H0....c..
  5930.      060   44 4F 53 20 20 20 20 20 20 20 20 13 00 00 00 00     DOS        .....
  5931.      070   00 00 00 00 00 00 11 A2 3F 10 28 00 00 00 00 00     ......."?.(.....
  5932.      080   54 4F 53 48 49 42 41 31 36 30 30 28 00 00 00 00     Toshiba1600(....
  5933.      090   00 00 00 00 00 00 21 AC 9B 12 00 00 00 00 00 00     ......!,........
  5934.      0A0   54 41 53 4D 20 20 20 20 20 20 20 13 00 00 00 00     TASM       .....
  5935.      0B0   00 00 00 00 00 00 27 63 B5 12 BE 02 00 00 00 00     ......'c5.>.....
  5936.      0C0   E5 52 49 56 45 20 20 20 44 20 20 20 00 00 00 00     eRIVE   D   ....
  5937.      0D0   00 00 00 00 00 00 09 0F 38 13 9A 26 12 C0 05 00     ........8..&.@..
  5938.      0E0   55 54 49 4C 20 20 20 20 20 20 20 13 00 00 00 00     UTIL       .....
  5939.      0F0   00 00 00 00 00 00 31 AC 9B 12 66 01 00 00 00 00     ......1,..f.....
  5940.      100   48 4D 41 56 20 20 20 20 20 20 20 13 00 00 00 00     HMAV       .....
  5941.      110   00 00 00 00 00 00 D6 AE 9B 12 A2 01 00 00 00 00     ......V...".....
  5942.      120   4D 49 53 43 20 20 20 20 20 20 20 13 00 00 00 00     MISC       .....
  5943.      130   00 00 00 00 00 00 3A 7D CB 12 FD 08 00 00 00 00     ......:}K.}.....
  5944.      140   47 41 4D 45 53 20 20 20 20 20 20 13 00 00 00 00     GAMES      .....
  5945.  
  5946. -LOOK-   Drive C:\     bits=8  tab=8  line=?       [F1]:HELP       [Alt+F1]:MENU
  5947. ================================================================================
  5948.  
  5949.                                   Figure 24-2
  5950.  
  5951.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 24-6
  5952.  
  5953.  
  5954.  
  5955.    24.2.3 Who Owns That Cluster? - [Alt+o]
  5956.  
  5957.    While LOOKing at the raw disk data, pressing [Alt+o] tells you what file
  5958.    (or directory, or other disk structure) "owns" the displayed disk area.  If
  5959.    the display includes two sectors, the owner which is displayed will be for
  5960.    the sector at the top of the screen.
  5961.  
  5962.    If the sector is part of the system area at the beginning of the disk, a
  5963.    message will tell you which part of the system area it is:  boot sector,
  5964.    FAT, root directory, or "reserved".
  5965.  
  5966.    For other parts of the disk, particularly on a big one, finding the owner
  5967.    can take a loonnngggg time!  The DOS file system structures are not set up
  5968.    to make this kind of search easy.
  5969.  
  5970.    First, potentially all sectors in the File Allocation Table (FAT) must be
  5971.    scanned to find the one 12- or 16-bit FAT entry, if any, which contains the
  5972.    current cluster number.  (That's NOT the FAT entry for the current cluster;
  5973.    it's the entry that POINTS to the current cluster).
  5974.  
  5975.    Then, that scan must be repeated for the entry just found, and then perhaps
  5976.    again, until there is no FAT entry which points to the one being looked
  5977.    for.  That means we have found the first cluster in the chain.
  5978.  
  5979.    Once the first cluster has been found, we've just started.  Next, we must
  5980.    scan the drive's "tree" of directories, looking at each file entry in each
  5981.    directory to find the one that contains that "first cluster number" we
  5982.    found by scanning the FAT.
  5983.  
  5984. |  So patience, please!  Progress is shown throughout the process, first
  5985. |  displaying the FAT entry (cluster number) being searched for, and later
  5986. |  showing which directory is currently being checked.  If you decide it's all
  5987. |  taking too long, just press a key to terminate the search.
  5988.  
  5989.    When the owner is displayed, you may see that the first byte of the
  5990.    filename is a "?", which of course is not a valid filename.  This tells you
  5991.    that the file has been deleted, but the associated disk clusters have not
  5992.    yet been de-allocated.
  5993.  
  5994.    This is because some vendors' implementations of DOS, and some compressed
  5995.    disk drivers, do not de-allocate clusters when a file is deleted, but
  5996.    rather wait until the space is needed and then do a "garbage collection".
  5997.  
  5998.    If a cluster is marked as "allocated" in the FAT, but no owner can be found
  5999.    in the directory tree, that cluster is "lost", and can be reclaimed by
  6000.    running DOS's CHKDSK utility.
  6001.  
  6002.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 24-7
  6003.  
  6004.  
  6005.  
  6006.    24.2.4 COPY Unallocated Sectors ("Snoop") - [^u]
  6007.  
  6008.    You may create a file containing all currently-unallocated sectors on a
  6009.    disk (perhaps containing interesting -- to someone -- info from long-
  6010.    deleted files):  LOOK at the disk, and press [^u].
  6011.  
  6012.    The file will be created on that same disk, and thus eats up all the
  6013.    available space.  You may browse (i.e., "snoop") in the file, or whatever
  6014.    you like, but you'll eventually have to move it or delete it before you can
  6015.    do much more with that disk.
  6016.  
  6017.    EDDY will tell you the filename it used.  The name will consist of 8
  6018.    apparently random letters.  Actually, these are generated from the current
  6019.    date and time by DOS when it is requested to create a "temporary" file.
  6020.    The name is guaranteed by DOS to be unique within its directory.  There is
  6021.    nothing really different about a temporary file except its name.  It must
  6022.    be opened and closed just like any other file, and it doesn't go away
  6023.    automatically; if you want to get rid of it, you must explicitly delete it.
  6024.  
  6025.    If you want to prevent anyone with a copy of EDDY from snooping around in
  6026.    YOUR electronic dumpster, use the DESTROY Drive command (see Section 13.3.3)
  6027.  
  6028.  
  6029.    24.3 LOOK at Boot Sector - [^Home]
  6030.  
  6031.    While LOOKing at the raw disk data, pressing [^Home] moves the display to
  6032.    the boot sector.  A formatted, readable display of the information appears.
  6033.    The formatted display is cleared when any key is pressed.  It may be
  6034.    redisplayed by pressing [Tab].
  6035.  
  6036.    Some data is not available with all disks -- it depends on the version of
  6037.    DOS used to format the disk, NOT on the version of DOS currently being
  6038.    used.  Data that is not available in the boot sector being looked at is
  6039.    indicated by "?" in the appropriate field(s) of the display.
  6040.  
  6041.    Specifics such as the addresses of the individual fields, and which fields
  6042.    go with which DOS versions are beyond the scope of this manual.  Details of
  6043.    the boot sector format variations are provided in many books, such as Ray
  6044.    Duncan's classic "Advanced MSDOS Programming".
  6045.  
  6046.    However, there are a few frequently-asked questions:
  6047.  
  6048.    - What are "reserved sectors"?
  6049.         Reserved sectors are sectors on the logical disk (partition) which
  6050.         precede the first File Allocation Table area.  There is always at
  6051.         least one reserved sector:  the boot sector itself.
  6052.  
  6053.    - What are "hidden sectors"?  Hidden sectors are sectors on the physical
  6054.         disk that precede the first sector of the current logical disk
  6055.         (partition).  The number of hidden sectors is usually equal to or a
  6056.  
  6057.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 24-8
  6058.  
  6059.  
  6060.         multiple of the number of sectors per track; i.e., the Master Boot
  6061.         Record (see next section) is on sector one of track zero of the
  6062.         physical disk, and the rest of that track is unused, with the first
  6063.         logical partition starting on track one.
  6064.  
  6065.    - What is the strange-looking "drive #"?
  6066.         On disks whose format supports this field, you'll normally see "00",
  6067.         "80" or sometimes "81" hex.  "00" means this is not a physical hard
  6068.         disk; it may be a floppy, a compressed disk, a RAM disk, or some other
  6069.         driver-controlled device.  "80", "81", etc.  are assigned to physical
  6070.         hard disks connected to the system, and these are used with the
  6071.         physical, low-level disk i/o operations handled by BIOS interrupt 13h.
  6072.         This interrupt requires a drive number to be in register DL, as many
  6073.         books will tell you.  What most of them DON'T tell you is that this is
  6074.         a completely different drive number than the "0 = A, 1 = B, ..." that
  6075.         most DOS services use.  "80" means the first physical hard disk --
  6076.         typically, your "C:" drive.
  6077.  
  6078.    - Why doesn't the "volume label" match what I see in the EDIT display?
  6079.         What EDDY (or the DOS "dir" command) displays is the value stored in
  6080.         the root directory with the "volume" file attribute turned on.  The
  6081.         value in the boot sector (where the format supports it) is OFTEN the
  6082.         same, but need not be.  If you change the volume label (using [Alt+v]
  6083.         in EDIT mode), only the value in the root directory is affected.
  6084.  
  6085.  
  6086. |  24.4 LOOK at Partition Sector/Master Boot Record (MBR) - [@]
  6087.  
  6088.    When you are LOOKing at the disk, you may display the Master Boot Record
  6089. |  (also known as the "Partition Sector", which is more descriptive of its
  6090. |  function) either by pressing [@], or, if the disk display is showing the
  6091.    disk's boot sector (offset 00000000h), by pressing [PgUp].
  6092.  
  6093.    There's really not much to see there except the Partition Table (or
  6094.    possibly some sneaky virus infection).
  6095.  
  6096.    A readable display of the Partition Table is provided initially.  You may
  6097.    toggle between this and the raw, hex data display by pressing [Tab].
  6098.  
  6099.    Only true, physical hard disks have MBRs.  Floppies, RAM disks, compressed
  6100.    disks (e.g., DoubleSpace, Stacker), and other non-standard device driver-
  6101.    controlled disks (such as some external hard disks connected via the
  6102.    parallel port) do not.  Or at least, they don't have one that anything
  6103.    other than that specific device driver knows how to get at.  If the disk
  6104.    you are looking at does not have an MBR that can be accessed, EDDY will
  6105.    complain when you try to look at it.
  6106.  
  6107.    When a physical disk has more than one partition, DOS treats each as a
  6108.    separate logical disk.  It is these logical disks that you LOOK at with
  6109.    EDDY.  From any of the logical disks on the same physical disk, pressing
  6110.    [@] will display the same MBR -- there's only one per physical disk.
  6111.  
  6112.    EDDY does not allow patching of the MBR, in the interest of not making your
  6113.    hard disk data a totally unrecoverable loss!
  6114.  
  6115.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 24-9
  6116.  
  6117.  
  6118.  
  6119.    24.5 PATCH Anything on a Disk - [F4]
  6120.  
  6121.    You can patch disks without regard to logical or physical file structure
  6122.    (except for the MBR, as explained above).  This capability should be used
  6123.    with caution, as it is quite possible to make a disk unusable by patching
  6124.    the wrong byte(s).  The first part of the disk (before cluster 0002)
  6125.    contains formatting and space allocation information, and is the most
  6126.    sensitive area.  Therefore, EDDY will warn you and ask for confirmation
  6127.    before patching there.
  6128.  
  6129.    If this capability worries you, see the next section.
  6130.  
  6131.    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  6132.    WARNING!  USE GREAT CARE WITH SECTOR PATCHING ON "COMPRESSED" OR "EXTENDED"
  6133.    DRIVES -- I.E., DEVICES CREATED AND MANAGED BY DOUBLESPACE, STACKER, AND
  6134.    SIMILAR PRODUCTS.  PATCHING FILES STORED ON THOSE DISKS IS PERFECTLY SAFE,
  6135.    HOWEVER.  SEE SECTION 24.1 FOR MORE INFORMATION.
  6136.    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  6137.  
  6138.  
  6139.    24.6 That's Too Dangerous!
  6140.  
  6141.    These very powerful features can be extremely dangerous in the hands of an
  6142.    inexperienced user, or worse, someone who is intent on doing damage.  For
  6143.    this reason, some users prefer not to have all the capabilities readily
  6144.    available, especially on machines that may be used by more than one person.
  6145.  
  6146.    By creating a customized version of EDDY, you can PERMANENTLY disable the
  6147.    absolute sector patching feature.  Just answer "n" when the question:
  6148.                "Allow disk PATCHing by sector in new EDDY (y/n)?"
  6149.    is asked, and the customized version will have this feature disabled.  If
  6150.    you answer "y", you can change ANYTHING on a disk, including format data.
  6151.  
  6152.    Even if you customize again, using the disabled EDDY.COM as the master
  6153.    copy, sector patching cannot be re-enabled.  Your original copy of EDDY.COM
  6154.    (or EDDY.OLD, after customizing), will still do sector patching, however,
  6155.    so it should be kept safely tucked away where only you can get to it.
  6156.  
  6157.  
  6158.    24.7 FIND Strings Anywhere on a Disk - [Alt+f]
  6159.  
  6160.    The FIND command works the same as with a file.  Refer to Section 17.
  6161.  
  6162.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 25-1
  6163.  
  6164.  
  6165.    25. Working With Disk-Image Data
  6166.  
  6167.    You can copy entire disks -- boot sector, FAT, and all -- for backup or
  6168.    other purposes.  Some of the reasons you might want to do this are
  6169.    described below.
  6170.  
  6171.    You can also copy selected parts of a disk, which is primarily useful for
  6172.    data recovery purposes in situations where other methods fail.
  6173.  
  6174.    These functions are not available when LOOKing at remote (network) drives.
  6175.  
  6176.  
  6177.    25.1 COPY Disk Image - [Shift+F5]
  6178.  
  6179.    To copy an entire disk to a file, move the cursor to the "Drive" line of
  6180.    the display and press [Shift+F5].  The target directory must be on a
  6181.    separate disk, which must be larger than the disk being copied.
  6182.  
  6183.    The resulting disk-image file will, by default, be named "DRIVE.{x}", where
  6184.    "x" is the letter of the drive that was copied.  You may choose a different
  6185.    filename if you prefer.  If a file with this name already exists in the
  6186.    target directory, you'll get a warning message and EDDY will let you decide
  6187.    whether to proceed or not.  If you proceed, the existing file will be
  6188.    overwritten.
  6189.  
  6190. |  This file will be an exact image of your disk.
  6191.  
  6192. |  This feature will not work with compressed volumes (CVFs), nor with
  6193.    copy-protection schemes that use non-DOS formats for some or all parts of
  6194.    the disk.  Hidden files, non-standard directory structures, and unique boot
  6195.    programs are no problem, however.
  6196.  
  6197.    "That's interesting", you say, "but why would I want to do that?"
  6198.  
  6199.    There are several possible uses for this feature:
  6200.  
  6201.  
  6202.    a.  Upload/Download Entire Disks
  6203.  
  6204.    Sending entire disks electronically is difficult without EDDY.  If you have
  6205.    a disk you'd like to transmit via modem, use disk-image copying.
  6206.  
  6207.    Then you can compress the resulting file, and transmit.  (For maximum
  6208.    compression, use a newly-formatted disk to create your original.) The
  6209. |  receiver doesn't necessarily need a copy of EDDY, so long as he has SOME
  6210. |  similar utility that can restore from an exact-image file.
  6211.  
  6212.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 25-2
  6213.  
  6214.  
  6215.  
  6216.    b.  Make Multiple Disk Copies Quickly
  6217.  
  6218.    Another use for this feature is in making multiple copies of a single disk.
  6219.    Using EDDY to do a disk-image copy and then doing repeated disk-image
  6220.    restores, as described in Section 25.2 below, is a lot faster than
  6221.    repeating DOS's "diskcopy" several times.  It's particularly effective if
  6222.    you copy the disk image to a RAM disk.
  6223.  
  6224.  
  6225.    c.  Reduce Disks Needed for Backup
  6226.  
  6227.    A lot of software packages have a LOT of disks (Borland C++ comes to mind).
  6228.    Common sense tells us we should make backup copies of these disks, in case
  6229.    the originals go bad someday (There's ANOTHER 33 disks to store!).
  6230.  
  6231.    With EDDY, you can copy the original disks to image files, compress them
  6232.    with PKZIP or whatever, and copy two (sometimes 3) of those compressed
  6233.    files to one high-density disk.  You've just cut your backup disk count at
  6234.    least in half.
  6235.  
  6236.    If you ever need the backup, just uncompress the file for the disk you
  6237.    need, then use EDDY's disk-image restore, and you're ready to go.
  6238.  
  6239.  
  6240.    d.  No-Hassle Hard Disk Backup
  6241.  
  6242. |  If you have an older, smallish hard disk, and a second, larger one, you can
  6243. |  use disk-image copying to backup the smaller on the larger -- and it's MUCH
  6244. |  faster than other methods.  I routinely backup my old laptop's disk to an
  6245.    external hard disk.  It takes about 6 minutes, with NO disk swapping or
  6246.    other manual intervention, for a 20 MB hard disk.  And there are NO
  6247.    floppies to store and keep track of.
  6248.  
  6249.  
  6250.    25.2 Disk-Image Restore - [Shift+F5]
  6251.  
  6252.    This is the command that makes disk-image copying, described above, so
  6253.    useful.  This is how you rebuild identical-to-the-original, fully
  6254.    functional disks from the disk-image files.
  6255.  
  6256.    Pressing [Shift+F5] while the cursor is on a file previously created with
  6257.    EDDY's disk-image copy capability tags that file for copying in image
  6258.    format.  This type of copy overwrites an entire physical disk, including
  6259.    format, boot and file allocation information on the target disk.  The
  6260.    result is an exact copy of the disk originally used to create the file.
  6261.  
  6262.    When this command is used, the display will show "Copy image" next to the
  6263.    file involved.  The actual copying will be done only when you enter UPDATE,
  6264.    by pressing [Enter] as normal from EDIT.
  6265.  
  6266.    EDDY checks the disk format of the target disk against the information
  6267.    saved from the original disk.  If there is any difference, or if the file
  6268.    size has been changed since it was created, the restore will not proceed.
  6269.  
  6270.    Since the entire target disk will be overwritten by this operation,
  6271.    [Shift+F5] cannot be used if any other COPY or MOVE operations are pending.
  6272.  
  6273.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 25-3
  6274.  
  6275.  
  6276.  
  6277.    25.3  COPY Selected Disk Areas
  6278.  
  6279. |  When LOOKing at a disk, you may select areas to be marked using either
  6280. |  "disk" or "byte" marks.  See Section 8.6 for more information about marks
  6281. |  in general.  The following discussion specifically refers to "disk" marks.
  6282.  
  6283. |  The disk area mark/copy capability is particularly useful for recovering
  6284.    lost or damaged data when other methods fail.  This section describes the
  6285.    commands available to copy raw, disk-image data selectively.
  6286.  
  6287.    With these commands, you may copy all or parts of the DOS "system" area
  6288.    (the boot sector, FAT, root directory and any "hidden" sectors that may be
  6289.    part of your disk's format), or portions of the "data" area, where your
  6290.    files are -- or were -- stored.
  6291.  
  6292.    The resulting disk-image file will be named (by default) "SECTORS.{x}",
  6293.    where "x" is the letter of the drive that was copied.  You will be able to
  6294.    choose a different filename if you wish.
  6295.  
  6296.    If a file with this name already exists in the target directory, you'll get
  6297.    a warning message and EDDY will give you a choice as to how you wish to
  6298.    proceed:  either by overwriting the file or appending the new data to it.
  6299.  
  6300.    To COPY, you must first "mark" the areas desired.  This process is
  6301.    different, depending on which part of the disk is involved.  Marking is
  6302.    described in the next two sections.
  6303.  
  6304.    When you have defined the portion of the disk you want to copy, by marking
  6305.    it, press [Enter].  After you confirm -- as with other update-type
  6306.    operations -- by pressing [Enter] again, the area you have selected will be
  6307.    copied to the specified file in the target directory.
  6308.  
  6309.    If both the system area and the data area are marked, both will be copied.
  6310.  
  6311.    After copying is complete, EDDY unmarks all marked areas and remains in
  6312.    LOOK mode.  Mark additional areas as desired, and copy those areas as well.
  6313.    Repeat as needed (as long as there is enough space in the target).
  6314.  
  6315.    As long as you do not return to EDIT, all data copied will be added to the
  6316.    end of the data in the "SECTORS.{x}" (or other specified) file.  This lets
  6317.    you build that file without respect to the order of clusters on the disk.
  6318.  
  6319.  
  6320.    25.3.1  Mark Sectors (System Area) - [m]
  6321.  
  6322.    In the system area, EDDY treats the data as three logical groups:  the boot
  6323.    sector, plus any "hidden" sectors that may be present following it; the
  6324.    File Allocation Table(s); and the root directory.
  6325.  
  6326.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 25-4
  6327.  
  6328.  
  6329.  
  6330.    Select any or all of these to be copied, by positioning the LOOK display
  6331.    anywhere within the system area (e.g., by pressing [Home], [Home] to move
  6332.    to the boot sector) and then pressing [m] (for "mark").  To "UNDO" marking
  6333.    of data previously selected, press [F2].
  6334.  
  6335.    EDDY will ask which of the logical groups you wish to include in the COPY
  6336.    process.  You will also be asked if you want to include "system area
  6337.    descriptions" along with the copied data.  If you choose to do so, a brief
  6338.    text description will be placed in the file at the beginning of each
  6339.    logical data group, making it easy to identify each part of the data.
  6340.  
  6341.    Pressing [F2] (the "Undo" key) unmarks any sectors previously marked.
  6342.  
  6343.  
  6344.    25.3.2  Mark Clusters (Data Area) - [m]
  6345.  
  6346.    Clusters to be copied are marked by moving the LOOK display to the cluster
  6347.    desired, and pressing [m].  If no clusters are currently marked, the single
  6348.    displayed cluster will be marked.  If one or more clusters are already
  6349.    marked, the displayed cluster, plus all the clusters between it and the
  6350.    currently-marked clusters will be marked.  Thus, the marked area is always
  6351.    a contiguous set of clusters.
  6352.  
  6353.    Only areas of the disk which are formatted for file storage, i.e., cluster
  6354.    #2 and beyond, can be marked in this way.  Lower-numbered sectors (boot
  6355.    sector, FAT, root directory, etc.) may be marked and copied as described in
  6356.    the preceding section.
  6357.  
  6358.    Pressing [F2] (the "Undo" key) unmarks any clusters previously marked.
  6359.  
  6360.  
  6361.    25.3.3  Jump to Marked Area - [Alt+m]
  6362.  
  6363.    If you press [Alt+m], the display will move to the first marked sector or
  6364.    cluster, if any, unless it is already displayed.  In the latter case, if
  6365.    there are more marked clusters, the display will move to the last one.
  6366.    [Alt+m] has no effect if there are no marked areas, or if the entire disk
  6367.    is marked.
  6368.  
  6369.  
  6370.    25.4  Data Recovery
  6371.  
  6372.    When you accidentally delete a file, there are many excellent products to
  6373.    help you recover your data.  With luck, your file was allocated to contig-
  6374.    uous disk clusters, its directory entry has not been re-used, and no part
  6375.    of it has been overwritten.  In this case, and even some more complicated,
  6376.    these programs can often recover your file automatically.  If this solves
  6377.    your problem, congratulations!  There's nothing easier.
  6378.  
  6379.    However, normally Mr. Murphy has made his contribution by the time you
  6380.    realize you have a problem.  In this situation, EDDY offers facilities to
  6381.    assist you in recovering your data as easily as possible, and SAFELY!
  6382.  
  6383.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 25-5
  6384.  
  6385.  
  6386.  
  6387.    The job is made a little easier by some of the commands provided by EDDY.
  6388.    It is safe because all writes are to the target disk, which normally is
  6389.    physically separate from the one containing your data (you may override
  6390.    this if you choose).  Thus, there is no chance of making things worse, by
  6391.    erroneously patching FATs or directories, or by copying data you are trying
  6392.    to recover on top of data you will want to recover later.
  6393.  
  6394.    The steps for file recovery are...
  6395.  
  6396.    1.  Set your working directory to the directory which used to contain the
  6397.        file which had the data you want to recover.  Move to the "Drive X:
  6398.        is..." line and press [F3].
  6399.  
  6400. |  2.  If you have a second hard disk, or you have only a few unallocated
  6401. |      clusters -- not more than a floppy's-worth -- on your disk, there is an
  6402. |      extra safety precaution you can take at this point.  You may want to
  6403. |      create a "snoop" file, to ensure that whatever you do won't be
  6404. |      unrecoverable.  The snoop file will contain your data SOMEWHERE.  See
  6405. |      Section 24.2.4 for more on this.  After creating it, MOVE (not COPY) it
  6406. |      to another disk or diskette for safekeeping.  After the MOVE, the
  6407. |      clusters it occupied will be unallocated again, and you can proceed
  6408. |      with the steps below (see Step 6 for an explanation of why the clusters
  6409. |      need to be unallocated).  In case you make an error during the recovery
  6410. |      process, at least your data can still be found in the snoop file.
  6411.  
  6412. |  3.  Press [Alt+w] to move to the area of the disk containing the working
  6413. |      directory.  Continue with Step 4.
  6414.  
  6415.        If the directory has been deleted too, start with the (former) parent
  6416. |      directory as your working directory, and use Steps 4 and 5 to move to
  6417.        the disk area containing the deleted directory information.  Then begin
  6418. |      with Step 4 from there.
  6419.  
  6420. |  4.  Move the display until the line containing your deleted filename (or
  6421.        directory) is at the top of the display.  Only the first byte of the
  6422.        filename will be different:  that byte will be either "E5" or "05" hex;
  6423.        the rest of the name will be unchanged (Note that there is no "."
  6424.        between the name and extension parts).
  6425.  
  6426.        If you'd like a clear display of the directory entry at the top of the
  6427.        display, press [Alt+d].  This can be particularly useful if there are
  6428.        several entries that might be the one you're looking for, or if the
  6429.        name was only one byte long, because you may be able to identify the
  6430.        correct entry by the former size, date, time and/or attributes.
  6431.  
  6432.        If you don't find the filename in the first cluster of the directory,
  6433.        press [Alt+n] to move to the next cluster allocated to the directory,
  6434.        and continue looking for the filename.
  6435.  
  6436. |      If you can't find the filename, go to Step 6, below.
  6437.  
  6438.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 25-6
  6439.  
  6440.  
  6441.  
  6442. |  5.  When you have the filename at the top of the screen, press [Alt+s], to
  6443.        display the starting cluster of the deleted file.  If the data looks
  6444. |      like what you expected to find, proceed to Step 7.
  6445.  
  6446.        If the data there doesn't look like it belongs to that file, the
  6447.        cluster has probably been re-used by DOS to store another file.  In
  6448. |      this case, continue with Step 6.
  6449.  
  6450. |  6.  This step is needed when you have to do things the hard way -- when
  6451.        directory entries or data file space has been re-used, and things are
  6452.        not so easy to find.
  6453.  
  6454.        The task is to identify the first cluster containing data belonging to
  6455.        your file.  If you know what the data looked like, you may be able to
  6456.        locate it by using the FIND command to locate some known string.
  6457.  
  6458.        Otherwise, you'll have to scan through the clusters until you find one
  6459.        that contains likely-looking data.  This is not QUITE so hard as it
  6460.        might be, because EDDY provides you with a way of looking only at
  6461.        clusters which are currently unallocated, which is where any data from
  6462.        deleted files will be found.  (But see note at bottom of this page.)
  6463.        Use [Alt+u] to look at the unallocated clusters, one after another.
  6464.        This is still tedious, but at least it's better than deciphering the
  6465.        FAT to locate these clusters.
  6466.  
  6467.        When you've found the cluster you want to start recovering, proceed to
  6468.        the next step.
  6469.  
  6470. |  7.  Mark the selected cluster, using [m].
  6471.  
  6472. |  8.  Look at the next cluster.  If it looks like the next part of the file,
  6473.        mark it, too.  Repeat this step until the current cluster looks like
  6474.        it's from another file, or from this one, but out of sequence.
  6475.  
  6476. |  9.  Write the marked cluster(s), by pressing [Enter].
  6477.  
  6478. |  10. Find the next cluster that looks like it logically follows the last one
  6479. |      written, using FIND or [Alt+u], as appropriate (refer to Step 6 for an
  6480.        explanation of these).
  6481.  
  6482. |  11. Repeat steps 7 - 10 until you feel you have all the data from your file
  6483.        (or as much of it as is left, if other files have overwritten some of
  6484.        the clusters previously used by your file).
  6485.  
  6486. |  12. Your data will be found in the "SECTORS.{x}" file ("x" is the drive
  6487.        where your data was stored) in the target directory.
  6488.  
  6489.    NOTE:  Some vendors' implementations of DOS, and some compressed disk
  6490.    drivers, do not de-allocate clusters when a file is deleted, but rather
  6491.    wait until the space is needed and then do a "garbage collection".  This
  6492.    makes recovery of a deleted file MUCH easier, as the cluster allocation
  6493.    chain remains intact.  Just restore the first byte of the filename in the
  6494.    directory and Voila!, there's your file.
  6495.  
  6496.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 26-1
  6497.  
  6498.  
  6499.  
  6500.    26. Directory Optimization
  6501.  
  6502.    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  6503.    WARNING!  DIRECTORY OPTIMIZATION USES LOW-LEVEL, SOMETIMES UNDOCUMENTED
  6504.    FEATURES OF MS-DOS AND/OR BIOS CAPABILITIES TO PERFORM ITS TASKS.  ALTHOUGH
  6505.    EDDY HAS BEEN EXTENSIVELY TESTED, THERE IS ALWAYS A DANGER THAT EDDY MIGHT
  6506.    NOT EXECUTE CORRECTLY WITH THE COMBINATION OF SOFTWARE INSTALLED ON YOUR
  6507.    SYSTEM.  THE POTENTIAL FOR PROBLEMS IS ESPECIALLY ACUTE WHEN OPTIMIZATION
  6508.    FEATURES ARE USED WITH "COMPRESSED" OR "EXTENDED" DRIVES (CVFs) -- I.E.,
  6509.    DEVICES CREATED AND MANAGED BY DOUBLESPACE, STACKER, AND SIMILAR PRODUCTS.
  6510.    EDDY WILL WARN YOU WHENEVER THESE FEATURES ARE INVOKED FOR USE ON CVFs, BUT
  6511.    YOU MAY CHOOSE TO IGNORE THE WARNING.  BE CAREFUL!  BACK UP YOUR DATA
  6512.    BEFORE EXPERIMENTING!  SEE SECTION 24.1 FOR MORE INFORMATION.
  6513.    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  6514.  
  6515.    There are three main reasons for changing the order of directory entries on
  6516.    disk:  to improve access speed, to free wasted disk space, and/or to allow
  6517.    directory information to be presented in some non-standard sequence that's
  6518.    unique to a particular application or user's preference.
  6519.  
  6520.         Access Speed
  6521.         ------------
  6522.         When DOS needs to access a particular file or subdirectory, it
  6523.         does a sequential search from the top of the directory, until it
  6524.         either finds the entry it's looking for, a never-used directory
  6525.         slot, or the end of the directory.  Clearly, if the entry wanted
  6526.         is near the beginning, and there are no directory slots present
  6527.         that are marked as "deleted", it'll be found quicker.
  6528.  
  6529.         Disk Space
  6530.         ----------
  6531.         Directories may grow as large as necessary to hold as many files
  6532.         as are placed in them, up to the limit of available disk space --
  6533.         except for the root directory, which has a size fixed at format-
  6534.         ting time.  Once they have grown, they NEVER shrink, even if you
  6535.         delete all the files in them.  The only way they get smaller is
  6536.         when the entire directory is deleted -- OR use EDDY to erase
  6537.         deleted entries and free the associated space (directory packing).
  6538.  
  6539.         Non-standard Sequences
  6540.         ----------------------
  6541.         Many utilities offer a variety of sequences for sorting directo-
  6542.         ries:  typically filename, extension, size or timestamp.  However,
  6543.         sometimes there's a need to put directories in an arbitrary
  6544.         sequence, which can't be handled by the usual sorting utilities.
  6545.         This might be to get the directories in the desired order for a
  6546.         disk optimizer, or just because you prefer to see them listed
  6547.         that way.  EDDY lets you put things in any order you please, by
  6548.         using the "Shuffle" command (see Section 26.2).
  6549.  
  6550.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 26-2
  6551.  
  6552.  
  6553.  
  6554.    26.1 Sorting a Directory
  6555.  
  6556.    Directories are normally sorted for display purposes only (as described in
  6557.    Section 1.4.2) to group files in ways -- by name, date, etc. -- that make
  6558.    it easier to work with them.  Usually, displaying this way is enough, and
  6559.    there's no need to keep the sequence permanently on disk.
  6560.  
  6561.    When you do want to make the sequence permanent, however, just press
  6562.    [Shift] at the same time as you press the regular sorting commands; e.g.,
  6563.    press [Alt+Shift+n] for sorting by name, [Alt+Shift+d] for sorting by date,
  6564.    etc. -- except [Alt+Shift+u] has no effect.  When the directory has been
  6565.    sorted by using the shifted commands, the letter for the sequence code at
  6566.    the bottom of the screen will blink.
  6567.  
  6568.    The blinking sequence code indicates that when you UPDATE, the directory
  6569.    can be rewritten to disk in that sequence.  After all file-related UPDATE
  6570.    actions -- copy, move, delete, rename, etc. -- have been done, the
  6571.    message...
  6572.                       Write sorted directory to disk (y/n)?
  6573.    ...will appear, and EDDY will wait for your reply.  If you answer "y", the
  6574.    rewrite process will begin.
  6575.  
  6576.    If the working directory display includes only some of the files in the
  6577.    directory, due to a file specification used (e.g., "*.DOC"), or attribute
  6578.    or timestamp filtering, then the entries for those files will be rewritten
  6579.    first, before the remaining entries in the directory.  The result will be a
  6580.    directory display with two, separately sorted parts.
  6581.  
  6582.    Any entries marked as "erased" by DOS will be moved to the end of the
  6583.    directory, to minimize time wasted by DOS in searching through them when
  6584.    using the directory later.
  6585.  
  6586.    For a way to eliminate this wasted time altogether, refer to Section 26.3.
  6587.  
  6588.    Before starting the rewrite, a check is made to be sure no files are
  6589.    currently open in the directory.  Rewriting with open files is likely to
  6590.    cause directory corruption, as DOS maintains pointers to absolute disk
  6591.    locations for data about files that are open, and rewriting will probably
  6592.    move that data during the process.
  6593.  
  6594.    EDDY uses some undocumented data structures within DOS to check for open
  6595.    files.  If EDDY finds data there that doesn't look valid, and therefore is
  6596.    unable to check for open files, this message...
  6597.                    Unsure if files open. Sorting not attempted
  6598.    ...will be displayed.
  6599.  
  6600.    EDDY can sort directories with over 2000 entries (including any deleted
  6601.    entries), depending on available memory.
  6602.  
  6603.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 26-3
  6604.  
  6605.  
  6606.  
  6607.    26.2 Shuffling a Directory - [Alt+F6]
  6608.  
  6609.    EDDY lets you arrange your directories in any order* you wish.  Rather than
  6610.    sorting in the standard ways -- name, size, etc. -- you may move the
  6611.    directory entries around to suit your own preferences, and then write them
  6612.    permanently in that sequence.
  6613.  
  6614.    This is useful to improve access speed to frequently-used directories and
  6615.    files, by placing them at the beginning of their respective directories.
  6616.  
  6617.    Shuffling is accomplished as follows:
  6618.  
  6619.         1.  Move the cursor to the directory or file you wish to move, and
  6620.             press [Alt+F6].  The action tag "Shuffle..." will appear next to
  6621.             that entry.
  6622.  
  6623.         2.  Move the cursor to the entry located where you want the tagged
  6624.             entry to be placed, and press [Alt+F6] again.  The tagged entry
  6625.             will be moved to the position immediately after the current entry,
  6626.             and the tag "Shuffled" will appear next to that entry.
  6627.  
  6628.    These two steps may be repeated as often as desired, resulting in many
  6629.    "Shuffled" tags.
  6630.  
  6631.    An entry that is tagged for any other action, such as COPY or DELETE, may
  6632.    not be tagged for "Shuffle...".  If you do the second step on the same
  6633.    entry as the first, the only effect is to cancel the "Shuffle..." tag.
  6634.  
  6635.    If you UNDO a "Shuffled" entry, ALL "Shuffled" entries will be untagged.
  6636.    Also, if you re-sort the directory (or use any of several other commands
  6637.    that do a re-read of the directory without changing the sequence), any
  6638.    pending "Shuffled" tags will be cancelled.  You will be warned before this
  6639.    is done, so that you don't lose the tags accidentally.
  6640.  
  6641.    When one or more entries have been Shuffled, the sequence code shown at the
  6642.    bottom of the screen will change to a blinking "?".
  6643.  
  6644.    When you UPDATE, the directory will be rewritten in the order it is
  6645.    displayed, and after the UPDATE the indicated sequence will be "U"
  6646.    (unsorted).  All entries that were moved as a result of the shuffling will
  6647.    be shown as "shuffled" (the lowercase first letter indicating a completed
  6648.    action).
  6649.  
  6650.  
  6651.    ---------------------------------------------------------------------------
  6652.    * NOTE:  There are two exceptions to "any order":  the "." and ".." entries
  6653.    at the beginning of a subdirectory can't be moved, nor can the DOS system
  6654.    files (IBMBIO.COM, IBMDOS.COM or similar name) at the beginning of a root
  6655.    directory be moved.
  6656.  
  6657.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 26-4
  6658.  
  6659.  
  6660.  
  6661.    26.3 Packing a Directory
  6662.  
  6663.    Erased directory entries are placed at the end of the directory by the
  6664.    rewrite process.  However, they still occupy space and they still waste
  6665.    search time when a file is "Not found" (this can become significant with
  6666.    long PATH statements).  On the plus side, an erased entry MAY be used to
  6667.    recover a file deleted by mistake.
  6668.  
  6669.    If you are sure you won't need to recover any files deleted in a directory,
  6670.    then use EDDY to get rid of them.  Depending on how many there are, you may
  6671.    get some additional free space on your disk, as EDDY will shrink the
  6672.    directory to the minimum size needed to hold the entries remaining.  You
  6673.    will also eliminate time wasted in searching through them.
  6674.  
  6675.    When the directory rewrite process begins, if any directory slots are
  6676.    marked as "deleted", EDDY will ask...
  6677.                     Erase "deleted" directory entries (y/n)?
  6678.    If you answer "y", the directory will be "packed" as it is rewritten.
  6679.  
  6680.  
  6681.    26.4 Had a Problem?  Don't Panic!
  6682.  
  6683.    This process has been exhaustively tested by the author and many users,
  6684.    without any problems.  However, some of us are hesitant (read
  6685.    "intelligent") about using programs that mess with our disks in
  6686.    non-standard ways.  Therefore, the following information is offered.
  6687.  
  6688.    Sorting and rewriting directories cannot be done using the standard DOS
  6689.    application services.  EDDY handles this by writing directly to the
  6690.    directories, and using DOS services where available.  No non-standard
  6691.    manipulation of the File Allocation Table (FAT) is involved.
  6692.  
  6693.    The steps EDDY uses internally to sort and rewrite a subdirectory are:
  6694.  
  6695.         1.  Set the "directory" attribute OFF in the subdirectory's entry in
  6696.             the working directory.  DOS now treats the subdirectory as a file.
  6697.  
  6698.         2.  Read the "file", using standard DOS services.
  6699.  
  6700.         3.  Sort the directory entries in memory, and rewrite the "file"
  6701.             (packing it if appropriate), again using standard DOS services.
  6702.  
  6703.         4.  Turn the "directory" attribute back ON in the directory.
  6704.  
  6705.    If there is a problem with any of the above steps (e.g., a power failure
  6706.    during the update), recovery is straightforward.
  6707.  
  6708.    - If the subdirectory is still shown as a directory entry in its parent
  6709.    directory, there's no problem.
  6710.  
  6711.    - If there was a problem with step 4, the subdirectory will be shown as a
  6712.    "file" (i.e., no "directory" attribute) in the parent directory, with a
  6713.  
  6714.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 26-5
  6715.  
  6716.  
  6717.  
  6718.    length of zero.  Don't panic!  There's only one little bit that has to be
  6719.    changed.  To fix this problem, LOOK at the disk to display the raw
  6720.    directory data.  Move the display until the entry for the "file" is at the
  6721.    top, and PATCH offset 0Bh to "10h".  Your directory is now restored.  Exit
  6722.    from LOOK, and you'll see the result.
  6723.  
  6724.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 27-1
  6725.  
  6726.  
  6727.  
  6728.    27. Wasted Space
  6729.  
  6730.    This section DOES NOT apply to compressed drives (CVFs), such as those
  6731.    using Stacker or similar products.  See Section 27.4.
  6732.  
  6733. |  If you frequently see large numbers in the "bytes wasted" field (third
  6734. |  line) of EDDY's display, you are probably wasting more of your disk space
  6735. |  than you need to.
  6736.  
  6737.    If you have lots of small files, the wasted space can easily be over half
  6738.    the capacity of your disk.  Look at a directory that contains mostly batch
  6739. |  files; you'll probably find that MOST of the space is wasted.  The next
  6740. |  section offers a method for dealing with this.
  6741.  
  6742.    If you're already familiar with the details of the DOS file system, you may
  6743.    want to skip directly to the next section.  For the best in-depth
  6744.    discussion of this subject that I've found, see "Hard Disk Secrets", by
  6745.    John Goodman, published by IDG Books Worldwide, Inc., 1993.
  6746.  
  6747.    DOS allocates space for files in units called "clusters", which are powers-
  6748.    of-2 multiples of disk sectors (a sector is usually 512 bytes).  A typical
  6749.    hard disk cluster size is 8192, with 16384 and larger becoming more common.
  6750.  
  6751.    Physical disks may be divided into logical volumes (partitions) by using
  6752.    DOS's "FDISK" command.  Larger partitions have larger cluster sizes.  The
  6753.    actual number of clusters formatted for any given disk depends both on the
  6754.    disk partition size and on the DOS version that was used to format it.
  6755.    DOS's file system is limited to a theoretical maximum of 65,518 clusters
  6756.    per partition (the number of clusters must be representable in no more than
  6757.    16 bits, cluster numbers begin with 2, and some of the numbers at the end
  6758.    of the range have special meanings; hence the strange maximum value).
  6759.  
  6760.    Allocation by clusters means that a file with only one byte of data in it
  6761.    will still occupy 8192 bytes (or whatever your cluster size is) of disk
  6762.    space.  The other 8191 bytes are completely wasted, and unusable for
  6763.    storing any other data.
  6764.  
  6765.    File sizes are the number of bytes of data in the files, rather than space
  6766.    on the disk assigned to the files; thus, the "bytes used" is almost always
  6767.    larger than the total of the file sizes.  This difference is reflected in
  6768.    the number indicated as "bytes wasted", on the third line of the display.
  6769.    The calculation is:
  6770.        bytes-wasted = (clusters-used * bytes-per-cluster) - sum-of-file-sizes.
  6771.  
  6772.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 27-2
  6773.  
  6774.  
  6775.  
  6776. |  27.1  Reclaiming Wasted Space
  6777. |
  6778. |  While EDDY can't actually solve your wasted space problems, it does alert
  6779. |  to the situation, and gives you some help in deciding what to do about it.
  6780. |
  6781. |  The way to reclaim the space is by using DOS's FDISK command to divide your
  6782. |  disk into two or more smaller partitions, each with a smaller cluster size.
  6783. |
  6784. |  First, LOOK at your disk by pressing [F3] on the "Drive..." line of the
  6785. |  display, then press [@] to view the Master Boot Record (MBR), sometimes
  6786. |  called the "Partition Sector".  If there is no MBR, as with RAM disks,
  6787. |  CVFs, and diskettes, no re-partitioning can be done, and you may as well
  6788. |  skip the rest of this discussion.
  6789. |
  6790. |  The obligatory caution statement:  DO A FULL BACKUP BEFORE YOU USE FDISK,
  6791. |  OR YOU'LL LOSE ALL YOUR DATA.  THIS PROCESS REQUIRES A COMPLETE FORMAT OF
  6792. |  YOUR DISK, AND THEN YOU MUST RELOAD ALL YOUR PROGRAMS AND DATA.
  6793. |
  6794. |  The partition size you should choose depends on a variety of factors, such
  6795. |  as the average sizes of files to be stored, the version of DOS you are
  6796. |  using, and your willingness to deal with the complexity of multiple
  6797. |  partitions (e.g., remembering which partition a particular file is in).
  6798. |
  6799. |
  6800. |  27.2 Choosing a Partition Size - [F11]
  6801. |
  6802. |  If your keyboard doesn't have an [F11], see Appendix A, Section I.
  6803. |
  6804. |  The choice of partition size is governed by how big you want the clusters
  6805. |  to be.  More on this relationship in the next section.
  6806. |
  6807. |  Press [F11] to see what the effect would be of choosing various cluster
  6808. |  sizes.  When you do this, the third line of the display changes to show the
  6809. |  space that WOULD be used IF you were to choose the cluster size shown.
  6810. |
  6811. |  The first time you press [F11], the number shown will be for a cluster
  6812. |  size of 512 bytes; this size can only be used with diskettes, and is shown
  6813. |  to let you consider whether you might want to store the files that way.
  6814. |
  6815. |  Subsequent presses of [F11] display bytes needed for other, larger
  6816. |  cluster sizes:  1024 (also diskette-only), 2048, 4096, 8192, 16384, and
  6817. |  32768.  One of these sizes -- the one actually in use on your disk -- won't
  6818. |  be shown, as it's the number already displayed on line two.
  6819. |
  6820. |  When the "cluster = 32768" is displayed, the next [F11] will return you to
  6821. |  the normal "bytes wasted" display.
  6822. |
  6823. |  The partition size you should choose is of course the one that has the
  6824. |  cluster size with the smallest space requirement (ignoring 512 and 1024).
  6825.  
  6826.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 27-3
  6827.  
  6828.  
  6829.  
  6830. |  Remember that the numbers you are looking at are for only a single
  6831. |  directory at a time.  That directory may or may not be representative of
  6832. |  your entire disk.  You should go through this process for most of the
  6833. |  largest directories (in terms of number of files) on your disk before
  6834. |  finally deciding on whether repartitioning is actually worth the trouble,
  6835. |  (i.e., can you save LOTS of space?) and if so, the best size to use.
  6836. |
  6837. |  In general, of course, smaller is better.  The trade-off on a large hard
  6838. |  disk is that if you use smaller partitions in order to get smaller
  6839. |  clusters, you'll need more of them, making use of your system more complex.
  6840.  
  6841.  
  6842. |  27.3 Partition Possibilities
  6843.  
  6844. |  The following information is offered to help you in deciding what partition
  6845. |  sizes might be appropriate for your hard disk.
  6846.  
  6847.    - DOS 2.x always uses a cluster size of 4096, and a partition can be a
  6848.      maximum of 32 MB.
  6849.  
  6850.    - DOS 3.x is also limited to 32 MB partitions, but cluster size may vary
  6851.      according to the specific DOS version and the size of the File Allocation
  6852.      Table (FAT) entries used (12- or 16-bit).  FAT size is chosen by DOS,
  6853.      based on partition size combined with day of the week (or some other
  6854.      equally-unobvious factor).
  6855.  
  6856.      . partitions up to 8 MB may have 2048-byte clusters with 12-bit FATs
  6857.      . partitions of 8 to 15 MB may have 4096-byte clusters with 12-bit FATs
  6858.      . partitions of 16 to 32 MB may have 2048-byte clusters with 16-bit FATs
  6859.  
  6860.    - DOS 4.0 and above are able to handle disk partitions larger than 32 MB.
  6861.      Partitions less than 16 MB may be given 12-bit FATS, and handled as
  6862.      described for DOS 3.x, above.  Partitions of 16 MB or greater always have
  6863.      16-bit FATs, and the following cluster sizes:
  6864.  
  6865.          16 -  127 MB:  2048-byte clusters
  6866.         128 -  255 MB:  4096
  6867.         256 -  511 MB:  8192
  6868.         512 - 1023 MB: 16384
  6869.        1024 - 2047 MB: 32768
  6870.  
  6871.  
  6872.    27.4  Compressed Volume File (CVF) Space Usage
  6873.  
  6874.    With "compressed volumes" (managed by disk compression software such as
  6875.    Stacker, DoubleSpace, etc.), although usage is still expressed in clusters
  6876.    for compatibility with DOS, the unused space in a cluster is managed
  6877.    internally by the software, and very little is actually wasted.
  6878.  
  6879.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 27-4
  6880.  
  6881.  
  6882.  
  6883.    In general, disk compression software would take a maximum of 1 sector (512
  6884.    bytes) to store the example 1-byte file, but it would still report a full
  6885. |  cluster used (e.g., 8192 bytes) for DOS compatibility.  Internally, the
  6886.    software would actually use the remainder of the cluster (15 sectors, 7680
  6887.    bytes) for storing other files.  Some software even uses the slack space
  6888.    WITHIN a sector, resulting in still more effective compression.
  6889.  
  6890.    Actually, things are not quite this straightforward (are they ever?).  The
  6891.    disk compression software reports to DOS more free space on the disk than
  6892.    actually exists, since it normally expects to compress files by about 2:1.
  6893.    Reporting actual space would make DOS think the "disk" was full when there
  6894.    was really space for more (compressed) files.
  6895.  
  6896.    To calculate the TRUE space utilization for a CVF requires a detailed
  6897.    knowledge of the algorithms and data structures, which are different for
  6898.    each product.  In most cases, the information is not generally available.
  6899.  
  6900. |  Thus the actual amount of wasted space (if any) is unknown for a compressed
  6901. |  disk.  Therefore, the "wasted space" calculation is not done for CVFs, as
  6902. |  the compression products themselves have already optimized this number by
  6903. |  their own methods.  Some of these products provide configuration parameters
  6904. |  (such as expected compression ratio) and/or extra-compression utilities
  6905. |  that you can use to squeeze the last bit of waste -- better than is
  6906. |  achieved by the on-the-fly methods -- out of files that don't get changed
  6907. |  or moved around.  Short of changing to a different compression product,
  6908. |  there's not a lot you can do to improve on this.
  6909.  
  6910.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 28-1
  6911.  
  6912.  
  6913.  
  6914.    28.  UPDATE Mode - [Enter], [^Enter]
  6915.  
  6916.    When you want to apply to disk the changes you have indicated in EDIT mode,
  6917.    press [Enter] to go to UPDATE mode.  EDDY will display the net change in
  6918.    number of bytes used on disk which will result from your update.  A "+"
  6919.    means more bytes will be used, and a "-" means some bytes will be freed.
  6920.  
  6921.    Before actually writing anything to disk, EDDY will ask you to confirm that
  6922.    you want to proceed, by pressing [Enter] again.  This is to avoid writing
  6923.    to disk before you are ready because of touching a key by mistake.
  6924.  
  6925.    If you use [^Enter] to start the UPDATE, EDDY will ask you whether to put
  6926.    the current date/time on files copied.  UPDATE normally -- after [Enter] --
  6927.    leaves the timestamp unchanged on a file that has been copied.  If you use
  6928.    [^Enter] instead, EDDY will ask whether you want to do this or not.  (See
  6929.    discussion of the "timestamp" configuration parameter, in Section 30.3.2e).
  6930.  
  6931.  
  6932.    28.1 Applying changes
  6933.  
  6934.    As each file is processed, its EDIT mode display line is displayed,
  6935.    allowing you to monitor UPDATE's progress through the directory.  If a
  6936.    file's display line is not yet shown, nothing has been done to that file.
  6937.  
  6938.    After each file has been processed, EDDY checks to see if you have pressed
  6939.    a key.  If so, updating will be suspended.  All processing for the file
  6940.    being worked on will be completed, but no work will start on the next file.
  6941.  
  6942.    When UPDATE has been suspended, it may be resumed by pressing [Enter] (or
  6943.    [^Enter], if you want to change the way timestamps on any further copied
  6944.    files are treated).  If you press [Esc], EDDY returns to EDIT mode, leaving
  6945.    intact any requests for changes not yet processed by UPDATE; these changes
  6946.    may be UNDOne if desired, or UPDATEd later.
  6947.  
  6948.    UPDATE does Deletes and Destroys first.  After deletions, a second pass is
  6949.    made to apply any other requested changes.
  6950.  
  6951.    If there are errors during UPDATE processing, (read or write problems,
  6952.    e.g.) EDDY reports the error as indicated by DOS and suspends the UPDATE at
  6953.    that point.  You may resume the UPDATE or return to EDIT.
  6954.  
  6955.    After a successful UPDATE, pressing any key returns to EDIT.  If the key is
  6956.    one of EDDY's commands, it will be acted on.
  6957.  
  6958.    After an UPDATE, any files moved or deleted from the working directory will
  6959.    be shown grouped together at the end of the directory display, rather than
  6960.    in their original locations before the UPDATE.
  6961.  
  6962.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 28-2
  6963.  
  6964.  
  6965.  
  6966.    If there are more files in the directory than can be displayed by EDDY,
  6967.    files deleted or moved will not be shown; instead, additional files from
  6968.    the working directory will be displayed.
  6969.  
  6970.  
  6971.    28.2 Print a Record of Your Changes - [Alt+p] / [^p]
  6972.  
  6973.    While EDDY is waiting for confirmation to proceed with an UPDATE -- i.e.,
  6974.    after you have pressed [Enter] once, and before you press it a second time
  6975.    -- you may tell EDDY to print the changes as they are made.
  6976.  
  6977.    Press [Alt+p] to print.  Pressing [Alt+p] again turns printing off.
  6978.  
  6979.    You may turn printing on during the UPDATE by pressing [Alt+p].  Printing
  6980.    will begin with the next change.
  6981.  
  6982.  
  6983.    28.3 Target Capacity Check
  6984.  
  6985.    EDDY checks to be sure there is enough room on the target directory disk to
  6986.    satisfy any COPY or MOVE requests you made before starting the UPDATE.  If
  6987.    there is, EDDY proceeds as described above.
  6988.  
  6989.    However, when there is not enough room, you'll see the following:
  6990.  
  6991.                               Not enough room on X:
  6992. |                       Additional bytes needed: nnnnnnn
  6993.  
  6994.    "X:" is the target disk drive.  The number of additional bytes needed is
  6995.    calculated from the file sizes in the working directory and the cluster
  6996.    size of the target directory disk, and takes into account that EDDY does
  6997.    deletions first while updating.
  6998.  
  6999. |  After the two lines above, there'll be two more, which vary depending on
  7000. |  the situation.
  7001. |
  7002. |  1. If SOME copies or moves can be done:
  7003. |
  7004. |                            Can't do all COPY/MOVEs
  7005. |                        [Enter] to do what space allows
  7006. |
  7007. |  2. If no copies or moves can be done, but there are other changes pending
  7008. |     (e.g., renaming or timestamp changes):
  7009. |
  7010. |                            Can't do any COPY/MOVEs
  7011. |                        [Enter] to apply other changes
  7012. |
  7013. |  3. If no copies or moves can be done, and no other changes are pending:
  7014. |
  7015. |                            Can't do any COPY/MOVEs
  7016. |                                 Press a key...
  7017.  
  7018.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 28-3
  7019.  
  7020.  
  7021.  
  7022.    To make room on the target disk, you must delete or move files occupying
  7023.    clusters equal to the total "bytes needed".  (Most files' sizes are not
  7024.    even cluster multiples, but the space allocated to them by DOS always is.)
  7025.  
  7026. |  During the UPDATE process, each file will have any renaming, timestamp
  7027. |  changes, or attribute setting applied. Then, if they are tagged for COPY or
  7028. |  MOVE they'll be checked be sure there is enough space for that operation.
  7029. |  If not, the following message will appear under the display for that file:
  7030. |
  7031. |                      Skipped...not enough room in target
  7032. |
  7033. |  and processing will continue with the next file.  The COPY or MOVE tag will
  7034. |  remain on the file when you return to EDIT mode.
  7035. |
  7036. |  There is no attempt to maximize or optimize the files copied or moved; they
  7037. |  are processed in the order displayed when you started the UPDATE.
  7038.  
  7039.    In some cases, EDDY may run out of disk space at some intermediate stage
  7040.    during COPY/MOVE operations, even though the summary indicates there is
  7041. |  enough space.  This may happen in three situations.  First, when all of
  7042.    these conditions occur:
  7043.  
  7044.         1.  Two or more files, for which there are files with the same name in
  7045.             the target directory, are being copied or moved.
  7046.  
  7047.         2.  Some of the files from the working directory use more clusters
  7048.             than their namesakes in the target directory, and some use fewer.
  7049.  
  7050. |       3.  The files that need more space in the target are copied or moved
  7051. |           before the ones requiring less.
  7052.  
  7053.    In this case, all free space could be filled before space is freed by the
  7054. |  copying or moving of the smaller files.  If this happens, the copy or move
  7055. |  will be "skipped", as described above.  When the UPDATE has completed, any
  7056. |  files that were skipped will still be tagged.  UPDATE again to copy those.
  7057.  
  7058.    A second situation that can cause the computed space requirement to be
  7059. |  inaccurate is when copying is done with TAB expansion (see Section 11.5.1).
  7060. |  TAB expansion (using a TAB interval 2 - 8) results in a file larger than
  7061.    the original.  As EDDY does not scan the file first to count the actual
  7062.    number of TABs in the file and calculate the number of additional bytes
  7063. |  that will result from the TAB expansion, it is possible to run out of space
  7064.    on the target disk.
  7065.  
  7066. |  Finally, this may occur on a compressed disk, when the compression software
  7067. |  fails to achieve the compression ratio it expected.  In this case, you'll
  7068. |  see the message:
  7069. |             Compressed disk appears to be full. COPY/MOVE aborted
  7070. |  which is explained further in Appendix B.
  7071.  
  7072.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 28-4
  7073.  
  7074.  
  7075.  
  7076.    28.4 Error Recovery
  7077.  
  7078.    28.4.1 Data Errors
  7079.  
  7080.    If a read error is encountered on a disk during a COPY or MOVE operation,
  7081.    EDDY offers five alternatives:
  7082.  
  7083.         1.  Abort the copy/move process.  In this case the DOS error code will
  7084.             be displayed, and no new copy will be produced.  EDDY will
  7085.             continue with any other updates that may have been requested for
  7086.             other files.
  7087.  
  7088.         2.  Retry.  If you choose this option, EDDY will start the copy
  7089.             process again from the beginning of the file.
  7090.  
  7091.         3.  Write a sector of "#" bytes in the new copy of the file in place
  7092.             of the sector that cannot be read.  The new copy will be the same
  7093.             length as the original.  All data which was in disk sectors that
  7094.             did not have have a problem will of course be copied intact.
  7095.  
  7096.             To see where the errors were, you might do a FIND on a string with
  7097.             several "#"s in a row.  (EDDY writes a full sector, minus 4 bytes,
  7098.             of "#"s -- the "#"s are preceded and followed by a CR,LF pair.)
  7099.  
  7100.             NOTE:  If you'd rather use some character other than "#", EDDY can
  7101.             be customized; see the "copy error" configuration parameter,
  7102.             described in Section 30.3.2e.
  7103.  
  7104.         4.  Copy the data actually read, even though DOS has indicated it is
  7105.             bad.
  7106.  
  7107.         5.  Skip the sector entirely, and write the next good block
  7108.             immediately after the previous block in the new copy.  This
  7109.             obviously results in a new copy that is shorter than the original.
  7110.  
  7111.             When this alternative is used, there is nothing in the new file to
  7112.             indicate where sectors have been deleted.
  7113.  
  7114.    SUGGESTION:  Select alternative 3, then rename the original and copy it
  7115.    again, this time choosing 4.  This allows you to see where the bad data is,
  7116.    by looking at the first copy, and to see just how "bad" the data is, by
  7117.    looking at the second copy.
  7118.  
  7119.    After the copy or move, the message displayed for the file(s) involved will
  7120.    be "copied(?)" or "moved(?)", to indicate that the new copy is not exactly
  7121.    the same as the original.  Also, the date and time on the new copy will
  7122.    always be the current date and time in this case.
  7123.  
  7124.    If multiple errors occur on a file, all will be treated in the same way,
  7125.    according to the alternative you select when the first was encountered.
  7126.  
  7127.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 28-5
  7128.  
  7129.  
  7130.  
  7131.    28.4.2 Cross-linked Files
  7132.  
  7133.    When EDDY copies a file, the number of bytes actually read is compared to
  7134.    the file size contained in the file's directory entry.  If there is a
  7135.    difference, you will see the message: "Size shown in directory incorrect".
  7136.  
  7137.    The most probable cause of this is that you have two files which have
  7138.    somehow had the same disk cluster assigned to them by DOS (This is NOT a
  7139.    problem caused by EDDY!).  You can verify that this is the case by running
  7140.    CHKDSK; CHKDSK will tell you which cluster is the overworked one, and would
  7141.    also normally tell you that there are some "lost allocation units".  Under-
  7142.    standing the situation is fairly straightforward; finding the cause is not!
  7143.  
  7144.    What this means is that you have the beginning of both files intact, up to
  7145.    the cluster where they are cross-linked.  After that cluster, you have the
  7146.    rest of ONE of those files.  The rest of the other file, minus whatever was
  7147.    stored in the problem cluster, is most likely to be found in the "lost
  7148.    allocation units".
  7149.  
  7150.    EDDY doesn't offer any special capabilities to help you, beyond providing a
  7151.    way to look at file contents and truncate files as required, but the
  7152.    following discussion is offered in the hope that it may help someone
  7153.    confronted with this problem for the first time.
  7154.  
  7155.    If you have this problem, to salvage what you can, do the following:
  7156.  
  7157.         1.  Copy both files to the target directory.  One of them will be
  7158.             correct (call this one "GOODFILE" for purposes of this
  7159.             discussion).  You'll probably have to LOOK at them or try running
  7160.             them to figure out which one that is.
  7161.  
  7162.         2.  Run CHKDSK /F to convert the "lost" bits to a file.  CHKDSK will
  7163.             give it a name like "FILE000n.CHK".  Multiple files will be
  7164.             created if there is more than one group ("chain") of lost
  7165.             clusters.
  7166.  
  7167.         3.  If the file that was NOT correct after this step (call this one
  7168.             "BADFILE") is a text file, LOOK at the ".CHK" file(s) to see if
  7169.             you can identify some data that appears to belong with BADFILE.
  7170.             If so, rename that .CHK file appropriately (say, "BADFILE.MOR").
  7171.             If BADFILE is not a text file, there's probably not much you can
  7172.             do, except proceed to step 6.
  7173.  
  7174.         4.  You may then use your editor, word processor, EDDY or whatever to
  7175.             chop off the erroneous data at the end of BADFILE.  (This is data
  7176.             that actually duplicates some of the correct data belonging to
  7177.             GOODFILE).
  7178.  
  7179.         5.  Then, using DOS's COPY command (or other tools as appropriate),
  7180.             rejoin the two parts -- e.g., COPY BADFILE+BADFILE.MOR BETTER.FIL.
  7181.  
  7182.         6.  Delete the remaining .CHK files after examining them to be sure
  7183.             the don't contain anything useful.
  7184.  
  7185.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 29-1
  7186.  
  7187.  
  7188.  
  7189.    29.  Batch Operations
  7190.  
  7191.    29.1 Commands Available
  7192.  
  7193.    In batch mode, you may COPY, MOVE, DELETE or DESTROY files.  The desired
  7194.    command is specified on the command line, as a "numeric" option.  The
  7195.    numbers used correspond to function keys used interactively...
  7196.  
  7197.              /5 - COPY files ([^F5])      /6 - MOVE files ([^F6])
  7198.              /7 - DELETE files ([^F7])    /8 - DESTROY files ([Shift+^F7])
  7199.  
  7200.    Other numeric options useful in batch mode are:
  7201.  
  7202.  
  7203.    29.2 Processing Sequence
  7204.  
  7205.    Option /1x - "x" defines the sequence (E = extension, D = date/time, N =
  7206.    name, etc.) in which files will be processed.  Lowercase inverts order.
  7207.  
  7208.  
  7209.    29.3 Synchronization Controls
  7210.  
  7211.    Option /2xxxxxx - "x"s define Synchronization Control settings (see Section
  7212.    10).  If the default settings are correct, /2 is not required.  Normal
  7213.    defaults are Y,Y,C,C,N,N.
  7214.  
  7215.    Thus, to COPY files newer than corresponding files in the target, enter a
  7216.    command like...
  7217.                                "EDDY/5  C:\WORK A:"
  7218.  
  7219.    To DELETE files that are duplicates of those in the target, enter...
  7220.                            "EDDY/7/2NNNNYY C:\WORK A:"
  7221.  
  7222.    Attribute and timestamp filters may be used to select files in batch mode.
  7223.    Files with read-only, hidden or system attributes will not be processed in
  7224.    batch mode unless they are explicitly selected by an attribute filter.
  7225.  
  7226.    If a file to be copied or moved is "read-only" in the target, the command
  7227.    will proceed only if the file is also read-only in the working directory.
  7228.    Otherwise, the file name will be displayed with a message to inform you of
  7229.    the situation, and the file will not be copied or moved.
  7230.  
  7231.    NOTE:  In batch mode the Control setting "C" works differently than it does
  7232.    when you use EDDY interactively.  If the condition is encountered corres-
  7233.    ponding to a Synchronization Control which is set to "C", the file name and
  7234.    the message describing the condition will be displayed for information
  7235.    only, and the file will NOT be copied, moved, or otherwise acted upon.
  7236.  
  7237.    When any of these messages are displayed, you'll hear a "beep".  If there
  7238.    are many such messages, so that they scroll off before you can read them,
  7239.    remember you may press [ScrollLock] anytime to pause the display.
  7240.  
  7241.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 29-2
  7242.  
  7243.  
  7244.  
  7245.    29.4 ERRORLEVEL
  7246.  
  7247.    Non-batch mode EDDY executions always leave DOS's ERRORLEVEL set to zero.
  7248.  
  7249.    When a batch mode execution finishes, ERRORLEVEL will be set according to
  7250.    the results, as follows:
  7251.  
  7252.         If all updates were done successfully, ERRORLEVEL will be set to zero.
  7253.         If updates were not done because no files qualified according to the
  7254.         criteria given by the Synchronization Controls, ERRORLEVEL will be set
  7255.         to 255.
  7256.  
  7257.         Any error encountered will terminate EDDY, and ERRORLEVEL will be set
  7258.         to the standard DOS error number as applicable (e.g., ERRORLEVEL = 2
  7259.         for "File not found", 3 for "Path not found", etc.).
  7260.  
  7261.    EDDY also provides informative displays of the ERRORLEVEL values returned
  7262.    by child processes -- i.e, commands executed via Point & Shoot -- during
  7263.    interactive (non-batch) operations.  See Section 14.1.1 for more on this.
  7264.  
  7265.  
  7266.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 30-1
  7267.  
  7268.  
  7269.  
  7270.    30.  EDDY's Default Settings are Lousy!
  7271.  
  7272.    You can't please all of the people all of the time.  With this in mind,
  7273.    EDDY is designed to be easy to "tailor" to your taste in several ways.
  7274.  
  7275.    EDDY can be customized, creating a new copy of EDDY.COM with the various
  7276.    colors, options, controls, etc. set the way you like them.
  7277.  
  7278.  
  7279.    30.1 Customizing - "EDDY/0"
  7280.  
  7281.    To customize, execute EDDY with option /0 (i.e., enter "EDDY/0") and use
  7282.    the normal commands available in the program to set the options, etc.  When
  7283.    you have everything set up the way you want it, press [Enter].
  7284.  
  7285.    You'll see a display of the various features that may be customized, to use
  7286.    as a final checklist.  Press any key to clear this display, and then tell
  7287.    EDDY to create a new copy of itself with the settings you have selected, by
  7288.    pressing [Enter] or [^Enter].  Normally, EDDY puts the current date/time on
  7289.    the new copy; if you want the old timestamp on the new copy, use [^Enter].
  7290.    (See also the discussion of the "timestamp" configuration parameter, in
  7291.    Section 30.3.2e).
  7292.  
  7293.    EDDY may be customized by two different methods (or a combination of the
  7294.    two).  The EDDY distribution package includes a file called "EDDY.INI".
  7295. |  This text file contains information (which you may edit as desired) which
  7296.    is used to set the default values for the program when you run EDDY/0.
  7297. |  After EDDY.INI has been read, EDDY displays the EDIT mode screen.  You may
  7298.    then modify the default settings by using EDDY's normal commands, as
  7299.    described below.  More on the use of EDDY.INI in Section 30.3.1.
  7300.  
  7301.  
  7302.    The customizable features, and the ways to set them, are:
  7303.  
  7304.     1. Screen colors (see Section 30.2)
  7305.         - use [Alt+r]  (note: [Alt+r] valid only during customizing)
  7306.  
  7307.     2. Options (see Section 2.2.1)
  7308.         - select via [Alt+o] or from the command line
  7309.  
  7310.     3. Synchronization Controls (see Section 10)
  7311.         - select via [Alt+c]
  7312.  
  7313.     4. Sort sequence (see Section 1.4.2)
  7314.         - use [Alt+d], [Alt+e], [Alt+h], [Alt+n], [Alt+s], [Alt+u] or [Alt+i]
  7315.  
  7316.           NOTE: If you use any of the above sort commands, then sorting
  7317.           by date/time when using a timestamp filter is not automatic.
  7318.  
  7319.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 30-2
  7320.  
  7321.  
  7322.  
  7323.     5. Default action for [Alt+w] and [Alt+t] (see Section 5.1.1)
  7324.  
  7325.     6. Default point-and-shoot command (see Section 14.2)
  7326.         - use [Shift+F8], and enter desired command
  7327.  
  7328. |   7. Attribute filter (see Section 18.1)
  7329.         - use [Alt+a], or from the command line, "+xx"
  7330.  
  7331.     8. Command key used with left mouse button (see Section 3.1.2a)
  7332.         - use [Alt+m], then press key for desired command
  7333.  
  7334.     9. Left- or right-handed mouse (see Section 3.1.2b)
  7335.         - use [Alt+m], then press right mouse button
  7336.  
  7337.    10. Mouse sensitivity (see Section 3.1.2c)
  7338.         - use [Alt+Shift+m], then move left or right
  7339.  
  7340.    11. LOOK mode bit-stripping, line-wrapping and TAB default settings
  7341.         (see Section 8.2.3)
  7342.         - in LOOK mode, use [Alt+b], [Alt+l] and [Alt+number], respectively
  7343.  
  7344.    12. Hex/ASCII toggle key (see Section 8.2.1a)
  7345.         - in LOOK mode, [Shift+Tab] allows selection of the key to be used
  7346.  
  7347.    13. Auto-scrolling speed (see Section 8.2.2)
  7348.         - in LOOK mode, use [^PgUp]/[^PgDn]
  7349.  
  7350.    14. Enable/disable absolute sector patching feature (see Section 24.6)
  7351.         - answer question: "Allow disk PATCHing by sector in new EDDY (y/n)?"
  7352.  
  7353.    15. Identify compressed disks permanently (see Section 24.1)
  7354.         - answer question: "Is <x:> a 'compressed disk'...(y/n)?"
  7355.  
  7356.    When customizing, no editing, copying, patching or other changes to the
  7357.    disk can be made.  The only purpose for this mode is to let you set things
  7358.    the way you want them, and then make a copy of EDDY with those settings.
  7359.  
  7360.    The customized version will be written to the directory EDDY was executed
  7361.    from, and will be named "EDDY.COM".  The original copy of EDDY will be
  7362.    renamed "EDDY.OLD".
  7363.  
  7364.    During the process of creating the new, customized EDDY.COM, there could be
  7365.    error conditions such as bad spots on the disk which cause the process to
  7366.    abort; if this occurs, you may see an error message referring to "EDDY.NEW"
  7367.    (e.g., "Error writing EDDY.NEW").  EDDY.NEW is the name given to the new
  7368.    copy during the customizing process, until it has completed without error;
  7369.    only then are the files renamed as described in the preceding paragraph.
  7370.  
  7371.    The messages "Where's EDDY.COM?" or "Incompatible EDDY.COM", mean EDDY.COM
  7372.    can't be found, or the version that's there is not the same as the version
  7373.    that's executing, respectively.
  7374.  
  7375.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 30-3
  7376.  
  7377.  
  7378.  
  7379.    30.2 Rainbow Selection - [Alt+r]
  7380.  
  7381.    In "customize" mode only, the [Alt+r] command is available to allow you to
  7382.    select the color combination for EDDY that best suits your monitor and
  7383. |  preferences.  [Alt+r] results in a display similar to Figure 30-1.
  7384.  
  7385. ================================================================================
  7386. filename.ext      size  mmddyy     time   RHSDAN
  7387. DIR of C:\*.*                                                                 |
  7388. Drive C: "John's Disk"        9 files,     77824 bytes,   102342656 bytes free |
  7389.                                            12124 bytes wasted, cluster = 4096  |
  7390. BAT          <DIR>     12-23-95  5:39:18p ...D..            |======|           |
  7391. BOOT         <DIR>     |================================|   | MENU |           |
  7392. SYS          <DIR>     |      SELECT SCREEN COLORS      |   |======|           |
  7393. UTIL         <DIR>     |                                |   [Alt+F1]           >
  7394. WINDOWS      <DIR>     |    For next color on  Press    |             |===|    |
  7395. AUTOEXEC BAT       142 |    -----------------  -----    |   |======|  | R |    |
  7396. COMMAND  COM     55777 |    Headings            [h]     |   | HELP |  | E |    |
  7397. CONFIG   SYS       432 |    Text body           [t]     |   |======|  | G |    |
  7398. WINA20   386      9349 |    Cursor line         [c]     |     [F1]    | I |    |
  7399.                        |    Windows             [w]     |             | S |    |
  7400.                        |  (Upper case for prev color)   |   |======|  | T |    |
  7401.                        |                                |   | LOOK |  | E |    |
  7402.                        |[Enter] when you like the colors|   |======|  | R |    |
  7403.                        |    [*] to restore defaults     |   [Enter]   |===|    |
  7404.                        | [Alt+F1] for menu/HELP colors  |            [Alt+z]]  |
  7405.                        |================================|   |======|           |
  7406.                                                             | QUIT |           |
  7407.                                                             |======|           |
  7408.                                                              [F10]             |
  7409.                                                                   Target: none |
  7410. -CUST- seq=N         [F3]:LOOK        [F9]:DOS        [Enter] writes new EDDY
  7411. ================================================================================
  7412.  
  7413. |                                 Figure 30-1
  7414.  
  7415.    Pressing any of the indicated letters changes the color of the corres-
  7416.    ponding part of the display, cycling through all the available colors as
  7417.    you press repeatedly.  Upper case letters cycle in the opposite direction.
  7418.  
  7419.    When the colors are the way you want them, press [Enter].  Those colors
  7420.    will then be used with the new, customized copy of EDDY you create.
  7421.  
  7422. |  While the above window is displayed, if you press [Alt+F1], you'll get a
  7423. |  menu panel (see Section 3.3.2), which offers selections for modifying the
  7424. |  colors used for menus and help screens.
  7425.  
  7426.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 30-4
  7427.  
  7428.  
  7429.  
  7430.    30.3  Customizing a New Version of EDDY
  7431.  
  7432.    Once you have customized your copy of EDDY, your custom configuration is
  7433.    stored in a file called "EDDY.INI".  Use of this file makes it easy to
  7434.    upgrade to a new version of EDDY without having to go through the detailed
  7435.    customization process again.  It also allows easy transfer of your
  7436.    registration information to the new version without having to go through
  7437.    the patching process.  More information on this in Section 30.4.
  7438.  
  7439.    The only information that is not saved between customizations is whether a
  7440.    disk drive letter is actually a compressed volume.  Since this can change
  7441.    dynamically, the determination is made with each customization you do.
  7442.  
  7443.  
  7444.    30.3.1  EDDY.INI
  7445.  
  7446.    EDDY.INI is an ASCII text file which contains information ("configuration
  7447.    parameters") to initialize EDDY's default values when you run "EDDY/0".
  7448.    There is a line in EDDY.INI for every parameter which can be customized.
  7449.  
  7450.    When you see EDDY's directory display, the initialization from EDDY.INI has
  7451.    been completed.  You may then proceed to customize EDDY further, if you
  7452.    wish, using the commands and techniques described above.  When you have set
  7453.    up everything the way you prefer, and create your new, customized copy of
  7454.    EDDY (by pressing [Enter]), an updated EDDY.INI, with the new configuration
  7455.    parameters, will also be created.  The parameters in this new EDDY.INI may
  7456.    then be used as the basis for any more customizing you decide to do.
  7457.  
  7458.    When EDDY.INI is updated, the new configuration data is appended to the
  7459.    previous data in EDDY.INI, if any.  Also, each new set of data has a
  7460.    timestamp at the beginning.  This gives you a record of your configuration
  7461.    changes, and allows you to fall back to a previous configuration if you
  7462.    want (by deleting lines from EDDY.INI that were added after the desired
  7463.    configuration).  EDDY processes all lines in the file sequentially, so your
  7464.    latest configuration data will be the last applied.
  7465.  
  7466.    If any errors are found while processing EDDY.INI, the line numbers where
  7467.    the errors occurred will be listed, and those lines won't be processed.
  7468.    All other lines will be processed, and the customizing will continue
  7469.    normally.  To determine why a line was rejected, refer to the description
  7470.    provided in Section 30.3.2 for the particular parameter involved.
  7471.  
  7472.    EDDY.INI may be modified if you wish, using any tool that produces plain
  7473.    ASCII text.  If you have accumulated a lot of configuration data, due to
  7474.    multiple customizations, you may want to delete some of the older data.
  7475.  
  7476.    If you completely trash EDDY.INI, or accidentally delete it, don't worry.
  7477.    Customize with no EDDY.INI present, and a new one, fully commented and with
  7478.    parameters set to the current values used by your copy of EDDY will be
  7479.    created.
  7480.  
  7481.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 30-5
  7482.  
  7483.  
  7484.  
  7485.    EDDY.INI is NOT used to configure EDDY's settings during normal usage, as
  7486.    the file access and interpretation slows down the startup process a lot.
  7487.    If you prefer to use EDDY.INI every time EDDY runs, set the "configure"
  7488.    parameter to "y" in EDDY.INI, and execute "EDDY /0"; every subsequent run
  7489.    of that customized copy of EDDY will use EDDY.INI to get its parameters.
  7490.  
  7491.  
  7492.    30.3.2  Configuration Parameters
  7493.  
  7494.    Configuration parameters in EDDY.INI consist of a one- or two-word
  7495.    parameter identifier, followed by an "=" sign, and a parameter value, if
  7496.    desired.  Related parameters are grouped together as sections in the file,
  7497.    and are alphabetical within sections.  That grouping is also used in this
  7498.    document.
  7499.  
  7500.    The sections, and some examples of the types of parameters in them, are:
  7501.         [administrivia] - registration info
  7502.         [screen]        - colors, number of lines
  7503.         [mouse]         - sensitivity, "handedness"
  7504.         [printer]       - port name
  7505.         [EDIT mode]     - options, synchronization controls, filters
  7506.         [LOOK mode]     - tab settings, hex/text toggle key
  7507.         [DOS Gateway]   - default command, supplementary prompt
  7508.  
  7509.    In EDDY.INI, the sections are provided for readability only; the order of
  7510.    the lines may be changed (or lines may be deleted) and the section headings
  7511.    may be changed or deleted, too.
  7512.  
  7513.    Anything following a ";" is treated as a comment.  Comments may be added or
  7514.    deleted as desired.
  7515.  
  7516.    For parameters that have "yes/no" values, "n" and "no" are treated the
  7517.    same, as are "y" and "yes".  Use whichever you prefer.
  7518.  
  7519.  
  7520.    a.  [administrivia]
  7521.  
  7522.      configure=
  7523.          Set this parameter to "y" (i.e., "configure=y") if you want EDDY.INI
  7524. |        to be used to control the settings EVERY time EDDY is run, whether
  7525. |        customizing or not.  This can be useful if you keep different
  7526. |        versions of EDDY.INI for use in different situations, copying the
  7527. |        appropriate one into EDDY's home directory at the time it is
  7528. |        required, before running EDDY.
  7529. |
  7530. |        (Obviously, this parameter will take effect only after you have run
  7531. |        EDDY/0 at least once with the "yes" setting).  If you choose to do
  7532.          this, expect EDDY to take a somewhat longer to display the first
  7533.          directory.  Default:  "n"
  7534.  
  7535.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 30-6
  7536.  
  7537.  
  7538.      name=
  7539.          The name of the person or organization to whom this copy of EDDY is
  7540.          registered.
  7541.  
  7542.      serial=
  7543. |        The registration serial number corresponding to "name".  This is a
  7544. |        six-byte string, based on the "name", provided to all registered
  7545. |        users.
  7546.  
  7547.  
  7548.     b. [screen]
  7549.  
  7550.      edit colors=
  7551.          Colors used for edit, look, and update mode displays.  These are
  7552.          four 3-byte strings, separated by commas.  If you want to change the
  7553.          colors, doing it interactively during customizing (by using [Alt+r])
  7554.          is much easier than trying to construct the parameter strings.  This
  7555.          parameter is primarily used as a means of recording the selected
  7556.          colors, rather than as a way of changing them (although you CAN
  7557.          change them this way, if you wish).
  7558.  
  7559.          The first byte is a letter:  "T" (for text), "H" (headings), "C"
  7560.          (cursor line) or "W" (windows), defining the part of the display that
  7561.          is to have this color.  Next are two hexadecimal digits defining the
  7562.          color to be used, and then an "h", which is really just a reminder
  7563.          that the digits are hex.
  7564.  
  7565.          The two hex digits represent one byte, which has the following
  7566.          format (bit 7 is the leftmost bit):
  7567.  
  7568.          bit 7:    1=foreground character blinks
  7569.          bits 6-4: color for background
  7570.                    (000=black, 001=blue, 010=green, 011=cyan, 100=red
  7571.                    101=magenta, 110=brown or dark yellow, 111=white)
  7572.          bit 3:    1=brighten foreground color
  7573.          bits 2-0: color for foreground character
  7574.                    (values same as for bits 6-4)
  7575.  
  7576.          The parameter line with EDDY's default color values would be:
  7577.                    "edit colors=T0Bh,H1Bh,C1Eh,W1Eh"
  7578.  
  7579.      help colors=
  7580.          Colors used for help and menu displays.  These are expressed as three
  7581.          4-byte strings, each in the same format as for "edit colors", as
  7582.          described above.  The first byte is one of: "T" (for text), "H"
  7583.          (highlights), or "C" (cursor line).
  7584.  
  7585.          The parameter line with EDDY's default color values would be:
  7586.                    "help colors=T07h,C0Eh,H70h"
  7587.  
  7588.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 30-7
  7589.  
  7590.  
  7591.  
  7592.      max lines=
  7593.          Normally, the physical capacity of a monitor, in terms of the number
  7594.          of lines it can display, can be detected automatically by EDDY.
  7595.          However, there are some special-purpose monitors that have more lines
  7596.          than the BIOS settings indicate.  In this case, EDDY's display would
  7597.          use only part of the screen space actually available.
  7598.  
  7599.          If you would like EDDY to use a different number of lines than are
  7600.          indicated by the BIOS, you may override the BIOS value by setting
  7601.          this parameter to that number (maximum value: 66).
  7602.  
  7603.          For the vast majority of monitors, the "max lines" parameter should
  7604.          be left with its default setting of "auto detect".
  7605.  
  7606.  
  7607.      c. [mouse]
  7608.  
  7609.      action=
  7610.          Key press to be simulated when primary mouse button is clicked.  See
  7611.          Section 30.3.3 for a description of how to specify a key to EDDY.
  7612.          Default: [F3].
  7613.  
  7614.      button=
  7615.          "left" or "right" identifies which mouse button is the primary one.
  7616.          Default: "left"
  7617.  
  7618.      double click=
  7619.          Defines the maximum amount of time that may separate two consecutive
  7620.          clicks and still have them recognized as a "double click".  It is
  7621.          specified in 10ths of a second, with legal values 1 through 9.
  7622.          Default: 4 (i.e., 4/10 of a second)
  7623.  
  7624. |    reset=
  7625. |        There are two ways to initialize the mouse to a known state: through
  7626. |        hardware functions, which is very reliable, but takes a long time
  7627. |        (more than a second); or through software only, which is almost
  7628. |        always OK, and is a lot quicker.  For more on this, see Appendix C.
  7629. |
  7630. |        Values for reset are: "sure" or "quick".  Default: "quick".
  7631.  
  7632.      sensitivity=
  7633.          Two 3-byte strings, specifying the sensitivity of the mouse in
  7634.          responding to movements.  The first byte of the string is either "h"
  7635.          or "v", indicating whether the string defines the "horizontal" or
  7636.          "vertical" sensitivity component.  Next are two decimal digits:  "00"
  7637.          is the least sensitive, "99" the most.  Defaults are "h25,v25".
  7638.  
  7639.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 30-8
  7640.  
  7641.  
  7642.  
  7643.      d. [printer]
  7644.  
  7645.      port=
  7646.          The hardware port to which the printer is attached.  Allowable values
  7647.          are "LPT1" - "LPT4".  Default: "LPT1".
  7648.  
  7649.  
  7650.      e. [EDIT mode]
  7651.  
  7652.      attributes filter=
  7653.          If you want to use an Attribute Filter as the default setting, it is
  7654.          specified by this parameter.  The format is as described in Section
  7655.          18.1.1.  Default: no filter.
  7656.  
  7657.      attributes style=
  7658.          This parameter determines the "style" in which file attributes will
  7659.          be displayed.  Valid styles are "1" and "2";  Figures 1-1 and 1-2
  7660.          illustrate these styles.  Default is "1".
  7661.  
  7662.      controls=
  7663.          Synchronization Controls (see Section 10).  Default: "YYNNCC".
  7664.  
  7665.      copy error=
  7666.          When EDDY finds data errors on a disk during a COPY operation, the
  7667.          bad sectors may be written out to contain all "#" bytes.  You may
  7668.          choose some other byte value if you wish.  Default is "#".
  7669.  
  7670. |    date style =
  7671. |        Specifies the format in which dates are to be displayed (see Section
  7672. |        1.4.6).  Valid specifiers are: "mdy", "dmy" and "ymd".  If used, this
  7673. |        parameter overrides the format defined by COUNTRY.SYS.  Default is to
  7674. |        use the format specified by COUNTRY.SYS, if present, or USA standard
  7675. |        (mm-dd-yy) format if not.
  7676.  
  7677.      easy look=
  7678.          Default operation is that when [Enter] is pressed in edit mode, and
  7679.          there are no pending updates, the action will be just as though [F3]
  7680.          had been pressed -- i.e., you look at the current file or directory.
  7681.          If you prefer to keep [Enter] dedicated for use only to applying
  7682.          updates, set this parameter to "no".  Default:  "yes".
  7683.  
  7684.      options=
  7685.          Options are described in Section 2.2.1.  An uppercase option letter
  7686.          means the option is OFF; lowercase means ON.  Default: all OFF.
  7687.  
  7688.  
  7689.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 30-9
  7690.  
  7691.  
  7692.  
  7693.      security=
  7694.          Defines the method used to overwrite files tagged for DESTROY.
  7695.             "ask" means ask for method to be used for each UPDATE
  7696.             "std" means use standard method
  7697.             "high" means use high-security method
  7698.          The actions taken for the standard and high-security settings are
  7699.          described in Section 13.3.   Default: "ask".
  7700.  
  7701.      sort=
  7702.          Sort sequence for EDDY's initial directory display:  N)ame.
  7703.          E)xtension, D)ate, S)ize, H)our, U)nsorted.  Uppercase means
  7704.          ascending order, lowercase means descending.  Default: "N".
  7705.  
  7706.      target=
  7707.          "box" or "tree" specifies whether target directory selection
  7708.          ([Alt+t]) is handled by the dialog box method or by tree display.
  7709.          Default:  "box".
  7710.  
  7711.      timestamp=
  7712.          Specifies how file timestamping is handled when [^Enter] (rather than
  7713.          [Enter]) is used to initiate a copy, patch or customize update; i.e.,
  7714.          does the file retain its existing timestamp, or get a new one?  With
  7715.          [Enter], the default actions are...
  7716.              - copy: retain timestamp
  7717.              - patch: new timestamp
  7718.              - customize: new timestamp
  7719.  
  7720.          Values allowed for this parameter are: "ask" or "auto".
  7721.  
  7722.          With [^Enter], and this parameter set to "ask", you will be asked
  7723.          how you want the timestamp to be handled; if set to "auto", no
  7724.          question will be asked, and the opposite action from the default
  7725.          described above will be used.  Default: "ask".
  7726.  
  7727.      work=
  7728.          "box" or "tree" specifies whether working directory selection
  7729.          ([Alt+w]) is handled by the dialog box method or by tree display.
  7730.          Default:  "box".
  7731.  
  7732.  
  7733.      f. [LOOK mode]
  7734.  
  7735.      auto scroll=
  7736.          Defines the relative speed at which auto-scrolling (see Section
  7737.          8.2.2) will occur.  This is a decimal digit, 1 thru 9.  Default: 3
  7738.  
  7739.      bit strip=
  7740.          If you want to have "bit-stripping" on as the default display mode,
  7741.          set this parameter to "y".  Default: "n"
  7742.  
  7743.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield  page 30-10
  7744.  
  7745.  
  7746.  
  7747.      hex toggle=
  7748.          If you prefer some key other than [Tab] (the default) for switching
  7749.          the look mode display between hex and ASCII text, set this parameter
  7750.          to the key you want to use.  The key you choose must be one that is
  7751.          not used for other look mode functions.  If there is a conflict, EDDY
  7752.          will use [Tab].  See Section 30.3.3 for a description of how to
  7753.          specify a key to EDDY.
  7754.  
  7755.      line wrap=
  7756.          Setting this parameter to "y" causes line wrapping to be turned on
  7757.          for look mode text displays.  Default: "n" (off).
  7758.  
  7759.      sector patch=
  7760.          If you wish to disallow use of EDDY for direct patching of disk
  7761.          sectors, set this parameter to "n".  More information on this
  7762.          parameter is in Section 24.6.
  7763.  
  7764.      snow OK=
  7765.          Used only with Color Graphics Adapter (CGA) monitors.  EDDY displays
  7766.          RAM (in LOOK mode) and updates the screen between keystrokes,
  7767.          allowing you to watch what's really happening there; i.e., some
  7768.          locations, such as the system clock, are constantly changing.
  7769.          However, updating with this frequency causes screen flicker with a
  7770.          CGA.  Most people find this very annoying, and so this "real time"
  7771.          display isn't normally done with a CGA.  If you REALLY want to try
  7772.          this, set "snow OK" to "yes", and have an aspirin ready.
  7773.  
  7774.      tabs=
  7775.          This parameter specifies the number of bytes per Tab interval.  Legal
  7776.          values are 0 thru 8.  Default: 8
  7777.  
  7778.  
  7779.      g. [DOS gateway]
  7780.  
  7781.      command=
  7782.          Pressing [Shift+F8] executes a default command.  That command is
  7783.          defined by this parameter.
  7784.  
  7785.      pause=
  7786.          If you want to pause after executing "command", in order to see
  7787.          what's on the screen before EDDY resumes control, set this parameter
  7788.          to "yes".  Otherwise, set it to "no".  Default: "yes".
  7789.  
  7790.      prompt=
  7791.          This parameter defines an addition to the DOS prompt displayed to
  7792.          remind you when you are using the DOS Gateway.  If you do not want
  7793.          any such reminder, set this parameter to "none".  Any other string
  7794.          (maximum length: 6 bytes) is used as the prompt.  Default: "Exit$g".
  7795.  
  7796.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield  page 30-11
  7797.  
  7798.  
  7799.  
  7800.      swap path=
  7801.          When you use the DOS Gateway, the memory available for processes you
  7802.          run while there may be maximized by using this parameter.  Specify
  7803.          the full path to be used for creating a "swap file" for temporary
  7804.          storage.  The swap file will be created only if you use the Gateway,
  7805.          and is deleted when EDDY terminates.  The swap file will use at most
  7806.          180K bytes.  On average, using the swap file will make about 120K
  7807.          more RAM available for Gateway processes.  I recommend not specifying
  7808.          the "root" as the path, although that will normally work; the problem
  7809.          is the root has a fixed limit on the number of files that can be
  7810.          stored there, and if there's no room, the swap file can't be created.
  7811.  
  7812.          If you specify a swap path, it will be used.  If you don't, but you
  7813.          use the DOS environment variable "TEMP", that path will be used.  To
  7814.          inhibit swapping entirely, set this "swap path" to "none".
  7815.  
  7816.  
  7817.    30.3.3  Defining a Key - [Alt+k]
  7818.  
  7819.    Two configuration parameters -- "action" and "hex toggle" -- allow you to
  7820.    choose keys that will be used for those purposes.  Keys are defined by
  7821.    strings in the same format as used throughout this document, and as
  7822.    displayed in various screens and messages produced by EDDY.
  7823.  
  7824.    These strings are formed as follows:  If the key is to be [Alt]-shifted,
  7825.    include "Alt+" as part of the string.  If [Shift] is to be used, include
  7826.    "Shift+".  If [Ctrl] is involved, precede the base key name with "^".
  7827.  
  7828.    Thus, if you wanted to use [Alt] and [Ctrl] with [F12], the definition
  7829.    string would be "[Alt+^F12].  If you wanted to use [Shift] as well, the
  7830.    string would be [Alt+Shift+^F12].
  7831.  
  7832.    Base key names are generally as shown on the keycap.  The "arrow" keys are
  7833.    referred to as ["Up]", "[Down]", "[Left]", and "[Right]".  If you are
  7834.    unsure of a key's name for use with EDDY, press [Alt+k] in edit mode,
  7835.    followed by a press of the key whose name you wish to know.
  7836.  
  7837.  
  7838.    30.4  How Do I Get Rid of the *$#^&! "UNREGISTERED" Message?
  7839.  
  7840.    That's an easy one: Register!  See Section 31 for details.  If you've
  7841.    already registered, read on...
  7842.  
  7843.    When you register EDDY v.7u or later, your registration information (name
  7844.    and registration serial number) is also stored in EDDY.INI.  Anytime you
  7845.    get a newer version, just run "EDDY/0", and the registration will be
  7846.    automatically be applied to your new copy.
  7847.  
  7848.    If you have registered a version earlier than EDDY v.7a, drop me a line and
  7849.    I'll send you the latest version, registered in your name.
  7850.  
  7851.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield  page 30-12
  7852.  
  7853.  
  7854.  
  7855.    If you have a version between 7a and 7t, you may find the name your copy
  7856.    is registered to, and the associated serial number, by LOOKing at EDDY.COM.
  7857.    The registered name is stored at offset 00000010h, and the 6-byte serial
  7858.    number at 00000025h (00000054h in version 7a, 00000055h in 7b).
  7859.  
  7860.    Write down the name and serial number exactly as they appear in EDDY.COM.
  7861.    Then either use EDDY to patch them into the new EDDY.COM at offsets 10h and
  7862.    25h, respectively, or enter them into the "name" and "serial" parameters in
  7863.    EDDY.INI, and run EDDY/0.
  7864.  
  7865.    Your new copy of EDDY will now display the "Registered to:  (your name)"
  7866.    message when you run it.  If not, you have probably made an error entering
  7867.    the name and/or serial number.  Just repeat the process to correct it.
  7868.  
  7869.  
  7870.    30.5  And How About the (expletive deleted) "REGISTER?" Button?
  7871.  
  7872.    If you print out EDDY's registration form -- [Alt+z] followed by [m] and
  7873.    then [y] or [Enter] -- the button will disappear for the remainder of that
  7874.    session with EDDY.  If the button is highlighted (i.e., you have "updated"
  7875.    at least 3 times), pressing [Alt+z] without printing will turn off the
  7876.    highlighting until the next update.
  7877.  
  7878. |  With a registered copy, the button will not be displayed at all.
  7879.  
  7880.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 31-1
  7881.  
  7882.  
  7883.  
  7884.    31.  Registration is FOREVER!
  7885.  
  7886.    If you have registered an earlier version of EDDY, refer to Section 30.4.
  7887.  
  7888.    If you find EDDY to be useful and satisfactory after a reasonable trial
  7889.    period (say, 30 days), and you continue to use EDDY, then you should
  7890.    register.  You may register by credit card, by mail, or by using the
  7891.    CompuServe SWREG facility.  More info on these in Sections 31.2 - 31.4.
  7892.  
  7893.    The low registration fee purchases a license, as described below.  It also
  7894.    entitles you to technical support as described in Section 32.1, to receive
  7895.    subsequent updates at cost of handling and distribution, as well as the
  7896.    satisfaction of knowing you have done "the right thing".  Also, the big
  7897.    "Register" button on the EDIT mode screen will no longer be displayed, and
  7898.    EDDY stops nagging you when you customize or do multiple updates.
  7899.  
  7900.    When you register, you will receive the latest version, registered in your
  7901.    name.  Once you have registered, the serial number you receive will be
  7902.    valid for all future releases of EDDY, as explained in Section 30.4.
  7903.  
  7904.    EDDY will (gently) remind you if your copy is not yet registered.  However,
  7905. |  all versions, registered or not, are fully functional as delivered -- not
  7906. |  "crippled" in any way.  All features are available to everyone.  BUT, if
  7907. |  you use an unregistered copy of EDDY frequently, over an extended period of
  7908. |  time, certain features will no longer be enabled.  In this case, you may
  7909. |  see this message:
  7910. |             Evaluation period expired!  [function] not enabled.
  7911. |  See Appendix B for more details regarding this message.
  7912.  
  7913.  
  7914.    31.1 Pricing
  7915.  
  7916.    "Users" means the number of people, on a network or separately, who may be
  7917.    using the program simultaneously.
  7918.  
  7919.    If ordering more than one copy, please specify the individual or company
  7920.    name(s) to whom the copies should be registered.
  7921.  
  7922. |       1 -  5 users ............................ each $29.95
  7923. |
  7924. |       6 - 25 users ............................ each $25.00
  7925. |
  7926. |       Larger quantity discounts and site licenses available.
  7927.  
  7928.  
  7929.    31.1.1 Payment
  7930.  
  7931.    All prices are expressed in US dollars.  Checks should be drawn on a US
  7932.    bank, payable in US dollars.  Non-US checks, in convertible currencies, are
  7933.    accepted at current exchange rates, but a hefty additional fee is charged
  7934.    by my bank to process them.  Therefore, if paying by non-US check, please
  7935. |  add $15 (i.e., a single registration is $44.95).
  7936.  
  7937.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 31-2
  7938.  
  7939.  
  7940.  
  7941.    31.1.2 Updates
  7942.  
  7943.    For those who can't find EDDY on a BBS or other source, updates are
  7944.    available to registered users at $5.00 per copy, to cover costs of postage
  7945.    and handling.
  7946.  
  7947.    When ordering, please specify the version you are currently using.
  7948.  
  7949.    NOTE:  "Handling charges" have always been an annoying thing to me, but in
  7950.    the case of EDDY, there really is some "handling" other than putting things
  7951.    in an envelope and mailing:  each copy must have the registration info
  7952.    inserted, and then the registered copy is tested to be sure the disk is OK
  7953.    and no problems have been introduced in the process.
  7954.  
  7955.  
  7956.    31.2 Registering by Credit Card
  7957.  
  7958.    CREDIT CARD ORDERS ONLY
  7959.    +++++++++++++++++++++++
  7960.    You can order with MasterCharge, Visa, American Express, or Discover from
  7961.    PsL -- Public (software) Library -- by calling 800-2424-PsL or 713-524-6394
  7962.    or by FAX to 713-524-6398 or by CIS Email to 71355,470.  You can also mail
  7963.    credit card orders to PsL at P.O.Box 35705, Houston, TX 77235-5705.
  7964.  
  7965.    Please refer to item number 10740 when ordering by credit card.
  7966.  
  7967.    THE ABOVE PHONE/FAX NUMBERS ARE FOR ORDERS ONLY
  7968.    +++++++++++++++++++++++++++++++++++++++++++++++
  7969.    Please DO NOT send credit card orders directly to the author.  This will
  7970.    only delay shipment.  I am not able to process credit card orders, and
  7971.    must send them back to you with a request to resubmit through PsL.
  7972.  
  7973.    Any questions about the status of the shipment of the order, refunds,
  7974.    registration options, product details, technical support, volume discounts,
  7975.    dealer pricing, site licenses, etc, must be directed to John Scofield, at
  7976.    the address shown on the logo when you exit from EDDY.
  7977.  
  7978.    To insure that you get the latest version, PsL will notify me via email the
  7979.    day of your order,  and I'll ship the latest version directly to you.
  7980.  
  7981.  
  7982.    31.3 Registering by Mail
  7983.  
  7984.    To register by mail, use the form provided by PRINTing the last page  of
  7985.    this file (EDDY.DOC), or by running the "EDDY_REG.BAT" file.  Or print a
  7986.    copy of the form by pressing [Alt+z] from EDIT mode.  Then mail the form
  7987.    with your check to the address shown when you exit from EDDY.
  7988.  
  7989.    For checks drawn on a non-US bank, please don't forget the additional
  7990.    US$15 -- see Section 31.1.1.
  7991.  
  7992.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 31-3
  7993.  
  7994.  
  7995.  
  7996.    31.4 Registering via CompuServe - GO SWREG
  7997.  
  7998.    If you are a CompuServe user, you may register EDDY on-line.  Just "GO
  7999.    SWREG", and refer to product #4186.
  8000.  
  8001.  
  8002.    31.5 "The License"
  8003.  
  8004.    Registration purchases a license for the right to use the program -- NOT
  8005.    the program itself.  One registration fee entitles you to one ACTIVE copy
  8006.    of the program at any time.
  8007.  
  8008.    Here are the terms of the license:
  8009.  
  8010.        THIS SOFTWARE AND THE DISK ON WHICH IT IS  CONTAINED ARE LICENSED TO
  8011.        YOU, FOR YOUR OWN USE.  THIS IS  COPYRIGHTED  SOFTWARE.  YOU ARE NOT
  8012.        OBTAINING  TITLE TO THE SOFTWARE OR ANY  COPYRIGHT  RIGHTS.  YOU MAY
  8013.        NOT  SUBLICENSE, RENT, LEASE, CONVEY, MODIFY,  TRANSLATE, OR CONVERT
  8014.        THE SOFTWARE TO ANOTHER PROGRAMMING LANGUAGE FOR ANY PURPOSE.
  8015.  
  8016.        YOU MAY MAKE AS MANY  COPIES OF THIS  SOFTWARE AS YOU NEED.  YOU MAY
  8017.        USE THIS  SOFTWARE  ON MORE THAN ONE COMPUTER,  PROVIDED THERE IS NO
  8018.        CHANCE IT WILL BE USED  _SIMULTANEOUSLY_  ON MORE THAN ONE COMPUTER.
  8019.        IF YOU NEED TO USE THE SOFTWARE ON MORE THAN ONE COMPUTER AT A TIME,
  8020.        PLEASE CONTACT THE AUTHOR.  SITE LICENSES ARE AVAILABLE.
  8021.  
  8022.    Thanks to Steven Hudgik for the form and most of the wording used in the
  8023.    license and warranty disclaimers. His book, "Writing & Marketing Shareware"
  8024.    (Windcrest Books, 1992), is highly recommended.
  8025.  
  8026.  
  8027.    31.6 Pass A Copy to a Friend ("de-personalized")
  8028.  
  8029.    If you would like to pass along a copy of EDDY for someone else to try,
  8030.    that would be great!  However, some users feel uncomfortable in giving out
  8031.    a copy that shows their name every time it runs.  If you would like to
  8032.    "de-personalize" a copy before passing it on, just patch EDDY.COM at offset
  8033.    00000025 hex to 00 hex (or any other value different from what's currently
  8034.    there); that copy will become an "UNREGISTERED" copy.  Don't forget to
  8035.    remove your registration info from EDDY.INI, too.
  8036.  
  8037.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 31-4
  8038.  
  8039.  
  8040.  
  8041.    31.7 EDDY is NOT Free and NOT Public Domain!
  8042.  
  8043.    Although EDDY is distributed in this way, it is not free. It is also
  8044.    protected by copyright, and has not been released into the public domain.
  8045.  
  8046.    EDDY is shareware.  This means you are free to make copies, pass copies on
  8047.    to anyone else who may be interested, and take a reasonable time to "try
  8048.    before you buy" (I consider something on the order of 30 days to be
  8049.    "reasonable").  You are, however, expected to honor the "buy" obligation if
  8050.    the "try" is satisfactory.
  8051.  
  8052.    Copies of the program may not be sold for more than the cost of the medium
  8053.    they are copied on, plus reasonable handling charges.
  8054.  
  8055.    EDDY and this User's Manual may be copied ad lib provided the author's
  8056.    copyright notice and disclaimers of warranty are reproduced in full.
  8057.  
  8058.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 32-1
  8059.  
  8060.  
  8061.  
  8062.    32.  Distribution and Support / Disclaimer
  8063.  
  8064.    If you have a problem with EDDY, I'll do my best to help.  However, before
  8065.    we get to the specifics of such help, please consider the following:
  8066.  
  8067.    If you have not yet done so, please read the "DISCLAIMER" that appears both
  8068.    below and at the beginning of this file.  In part, this disclaimer means
  8069.    there is no representation that EDDY will do ANYTHING, whether or not the
  8070.    author or the documentation states or implies that it will.  Similarly,
  8071.    there is no representation that the program will NOT do anything harmful or
  8072.    annoying.  Whatever it may do or not do, the author is not responsible for
  8073.    the results.  Any person using EDDY bears all risk as to the quality and
  8074.    performance of the software, and the consequences of using it.
  8075.  
  8076.                        DISCLAIMER - PLEASE READ CAREFULLY!
  8077.    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  8078.       BY USING THIS PROGRAM, EDDY ("THE SOFTWARE"), WRITTEN BY JOHN SCOFIELD
  8079.       ("THE AUTHOR") YOU ACCEPT THESE TERMS:
  8080.  
  8081.         THE  SOFTWARE  AND  ITS  ASSOCIATED  DOCUMENTATION  ARE SUPPLIED
  8082.         "AS-IS", WITHOUT ANY WARRANTY OF ANY KIND.  THE AUTHOR EXPRESSLY
  8083.         AND SPECIFICALLY  DISCLAIMS ALL  REPRESENTATIONS AND  WARRANTIES
  8084.         RELATING TO THE SOFTWARE, WHETHER EXPRESS OR IMPLIED, INCLUDING,
  8085.         BUT  NOT   LIMITED  TO,  ANY  IMPLIED   WARRANTIES  OF  QUALITY,
  8086.         PERFORMANCE,   MERCHANTABILITY   OR  FITNESS  FOR  A  PARTICULAR
  8087.         PURPOSE.   NEITHER  THE  AUTHOR  NOR  ANYONE  ELSE WHO  HAS BEEN
  8088.         INVOLVED IN THE DELIVERY OF THE SOFTWARE SHALL BE LIABLE FOR ANY
  8089.         DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL  DAMAGES
  8090.         ARISING OUT OF THE USE OR  INABILITY TO USE THE  SOFTWARE OR FOR
  8091.         ANY LOSS  OR  DAMAGE  OF ANY  NATURE  CAUSED  TO  ANY  PERSON OR
  8092.         PROPERTY  AS A RESULT  OF THE USE OF THE  SOFTWARE,  EVEN IF THE
  8093.         AUTHOR HAS BEEN SPECIFICALLY  ADVISED OF THE POSSIBILITY OF SUCH
  8094.         DAMAGES OR CLAIMS.  THE AUTHOR IS NOT RESPONSIBLE FOR ANY COSTS,
  8095.         INCLUDING,  BUT NOT  LIMITED TO,  THOSE INCURRED  AS A RESULT OF
  8096.         LOST PROFITS  OR REVENUE,  LOSS OF USE OF THE SOFTWARE,  LOSS OF
  8097.         DATA,  THE  COSTS  OF  RECOVERING  ANY  SOFTWARE  OR  DATA,   OR
  8098.         THIRD-PARTY  CLAIMS.  IN NO EVENT  SHALL THE  AUTHOR'S LIABILITY
  8099.         FOR ANY DAMAGES TO YOU OR  ANY OTHER PARTY EVER EXCEED THE PRICE
  8100.         PAID FOR THE LICENSE TO USE THE SOFTWARE, REGARDLESS OF THE FORM
  8101.         OF THE CLAIM.
  8102.  
  8103.    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  8104.  
  8105.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 32-2
  8106.  
  8107.  
  8108.  
  8109.    32.1 Technical Support
  8110.  
  8111.    Technical support is guaranteed to be available to any registered user for
  8112.    at least six months from the date of registration.  In practice, support is
  8113.    available for an unlimited time; only if circumstances (e.g., illness) make
  8114.    it impractical to continue would support ever cease.
  8115.  
  8116.    In the unlikely event you (as a registered user) have a problem with EDDY
  8117.    (not a bug, surely!), if you take the trouble to report it, I'll try to
  8118.    solve it.  And I'll get back to you with a fix, if possible.
  8119.  
  8120.    With any problem report, please include the following information:
  8121.  
  8122.     1. Version number of your copy of EDDY (as shown on the logo
  8123.        which is displayed when you exit from EDDY)
  8124.  
  8125.     2. Level of MS- or PC-DOS you are using
  8126.  
  8127.     3. Any resident programs being used -
  8128.        - listings or copies of AUTOEXEC.BAT and CONFIG.SYS are very helpful!
  8129.  
  8130.     4. As complete a description of the problem as possible -
  8131.        - what did you enter on the command line?
  8132.        - what commands did you use just before the problem occurred?
  8133.             (the last 4-5 keystrokes, if possible)
  8134.        - how was EDDY's output different from what you expected?
  8135.        - IMPORTANT! A listing of your EDDY.INI file contents
  8136.        - [PrtSc] screen printouts before and after the problem (if possible)
  8137.        - any other information that seems relevant
  8138.  
  8139.     5. Hardware used
  8140.       (please provide the information from the following list that seems
  8141.       related to your problem) -
  8142.        - computer: brand name & model
  8143.        - memory size, and whether Expanded or Extended Memory installed
  8144.        - monitor: color or B/W, brand name & model, screen size (if not 25x80)
  8145.        - display adapter: Mono, CGA, EGA, VGA or ???; brand name & model
  8146.        - mouse, if any: number of buttons, brand name & model
  8147.        - working directory disk drive: type & size, brand name & model
  8148.        - target directory disk drive: type & size, brand name & model
  8149.        - any other hardware
  8150.  
  8151.     6. Your name, address and phone number
  8152.  
  8153.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 32-3
  8154.  
  8155.  
  8156.  
  8157.    32.2  How Can I Get in Touch With You?
  8158.  
  8159.    I move around a LOT;  both throughout the US and in various places around
  8160.    the world.  Mail eventually reaches me, but it sometimes takes a while
  8161.    longer than people expect.  Please try to be patient -- I WILL respond.
  8162.  
  8163.    Please send all correspondence to:  John Scofield
  8164.                                        117 West Harrison Bldg.
  8165.                                        6th floor, Dept. S-678
  8166.                                        Chicago, IL 60605 USA
  8167.  
  8168.    This address is a forwarding service.  If quicker contact/response is
  8169.    needed, and you have a modem, you may reach me via CompuServe:  70162,2357.
  8170.    If you have access to the Internet, e-mail may be sent to me at:
  8171.  
  8172.                                 scofield@ACM.org
  8173.  
  8174.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 32-4
  8175.  
  8176.  
  8177.  
  8178.    32.3  Where Can I Find the Latest Version?
  8179.  
  8180.    EDDY is available on CompuServe:  GO PCUTIL (formerly IBMSYS), LIB 6; and
  8181.    on many other BBSs, including the ASP Hub Network BBSs, which offer it as a
  8182.    free download.
  8183.  
  8184.    These BBSs are members of the ASP Hub Network (AHN):
  8185.  
  8186.    Zone 1 - East Coast USA
  8187.  
  8188.      North-East Coast                      Mid-East Coast
  8189.  
  8190.      [Site #1]                             [Site #2]
  8191.      The Consultant BBS                    The Break RBBS <East>
  8192.      Jay Caplan                            Bruce Jackson
  8193.      P.O. Box 8571                         4660 Whitaker PL
  8194.      New York NY 10116-4655                Dale City, VA 22193-3011
  8195.      BBS Phone: 718-837-3236               BBS Phone: 703-680-9269
  8196.      BBS Software: PCBoard                 BBS Software: RBBS
  8197.  
  8198.    Zone 2 - North Mid-USA               Zone 3 - Southern Mid-USA
  8199.  
  8200.      [Site #3]                             [Site #4]
  8201.      The Twilight Zone                     The DataExchange BBS
  8202.      John Hrusovszky                       Don Morris
  8203.      1119 E. Main St                       119 Herring St.
  8204.      Auburndale, WI 54412                  Leesville, LA 71446
  8205.      BBS Phone: 715-652-2758               BBS Phone: 318-239-2122
  8206.      BBS Software: RBBS                    BBS Software: UltraBBS
  8207.  
  8208.    Zone 4 - West Coast USA              Zone 5 - Canada
  8209.  
  8210.      [Site #5]                             [Site #6]
  8211.      Space BBS                             Knightec BBS
  8212.      Owen Hawkins                          Phil Knight
  8213.      PO Box X                              35 Robb Blvd #6
  8214.      Menlo Park, CA 94026                  Orangeville, ONT L9W 3L1
  8215.      BBS Phone: 415-323-4398 (ASP Files)   BBS Phone: 519-940-0007
  8216.      BBS Software: PCBoard                 BBS Software: PCBoard
  8217.  
  8218.    These BBSs are bound by special agreement with the ASP.  In the case of a
  8219.    dispute contact the ASP Ombudsman.
  8220.  
  8221.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page 32-5
  8222.  
  8223.  
  8224.  
  8225.    32.4  A.S.P. Ombudsman
  8226.  
  8227.    This program is produced by John Scofield, a member of the Association of
  8228.    Shareware Professionals (ASP).  ASP wants to make sure that the shareware
  8229.    principle works for you.  If you are unable to resolve a shareware-related
  8230.    problem with an ASP member by contacting the member directly, ASP may be
  8231.    able to help.  The ASP Ombudsman can help you resolve a dispute or problem
  8232.    with an ASP member, but does not provide technical support for members'
  8233.    products.
  8234.  
  8235.    Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI
  8236.    49442-9427 USA, FAX 616-788-2765 or send a message via CompuServe Mail to
  8237.    ASP Ombudsman 70007,3536
  8238.  
  8239.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page  A-1
  8240.  
  8241.  
  8242.                                    Appendix A
  8243.  
  8244.                 Command Reference (Keys: Shiftless and Otherwise)
  8245.  
  8246.    When a command applies only in a mode other than EDIT, the mode is
  8247.    indicated in parentheses after the command description.  If there is no
  8248.    mode indicated, EDIT mode is assumed.
  8249.  
  8250.    Some keys have different meanings, depending on the current mode and/or the
  8251.    type of line the cursor is on.  Although I have tried to minimize this,
  8252.    there just aren't enough separate keys to go around for all of EDDY's
  8253.    features; in line with the intention to minimize keystrokes required to get
  8254.    the job done, I have reluctantly chosen this approach as the lesser evil.
  8255.    Accordingly, the entries below to which this applies are indicated by the
  8256.    phrase "Depends on context".
  8257.  
  8258.  
  8259.    I. Function Keys
  8260.  
  8261. |  NOTE: If your keyboard does not have [F11] or [F12], the following
  8262. |  procedure may be used to simulate them for EDDY:
  8263. |       Press [Shift+Esc], release, then...
  8264. |       ...press [F1] to simulate [F11], or [F2] to simulate [F12]
  8265. |       ...press [F1] or [F2] together with [Ctrl], [Alt] or [Shift]
  8266. |          to simulate the equivalently-shifted [F11] or [F12]
  8267. |
  8268. |  Any other key pressed after [Shift+Esc] will be treated normally; i.e., as
  8269. |  though [Shift+Esc] had not been pressed.  Also, [Shift+Esc] affects ONLY
  8270. |  the keystroke IMMEDIATELY following it; i.e., pressing [Shift+Esc], [F1],
  8271. |  [F1] is the same as pressing [F11] followed by [F1].
  8272. |
  8273. |  In the current release of EDDY, only [F11], unshifted, is used.  However,
  8274. |  the additional simulations are available if you wish to use them for
  8275. |  customizing, as described in Section 31.3.2, for the "button" and "hex
  8276. |  toggle" parameters.
  8277.  
  8278.    [F1]            HELP
  8279.    [Alt+F1]        Display pull-down menus
  8280.    [Shift+F1]      Shortcut to keyword search in HELP screens
  8281.  
  8282.    [F2]            UNDO
  8283.    [^F2]           UNDO on all files
  8284.  
  8285.    [F3]            LOOK at file, directory, disk or RAM
  8286.    [^F3]           LOOK at all files
  8287.    [Alt+F3]        LOOK at file in target directory
  8288.    [Shift+F3]      Depends on context:
  8289.                    - EDIT (cursor on file or directory)...
  8290.                      ...compare directory entries in work and target
  8291.                    - EDIT (cursor on "DIR of" or "." line)...
  8292.                      ...compare snapshot file to current working directory
  8293.    [Shift+^F3]     Compare all files' directory entries in work and target
  8294.    [Alt+Shift+F3]  Compare current file's contents in work and target
  8295.  
  8296.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page  A-2
  8297.  
  8298.  
  8299.  
  8300. |  [F4]            PATCH file or RAM, or disk -- if already LOOKing at disk
  8301.  
  8302.    [F5]            Depends on context:
  8303.                    - EDIT...tag file or directory for COPY
  8304.                    - LOOK...COPY marked area
  8305.    [^F5]           Tag all files for COPY
  8306.    [Alt+F5]        COPY unmarked area (LOOK)
  8307.    [Shift+F5]      Depends on context:
  8308.                    - EDIT (cursor on "Drive" line)...
  8309.                      ...copy entire disk to file (disk-image copy)
  8310.                    - EDIT (cursor on file)...
  8311.                      ...copy image file to disk (disk-image restore)
  8312.                    - EDIT (cursor on "DIR of" or "." line)...
  8313.                      ...take snapshot of working directory
  8314.  
  8315.    [F6]            Tag file or directory for MOVE
  8316.    [^F6]           Tag all files for MOVE
  8317.    [Alt+F6]        Shuffle directory entries
  8318.  
  8319.    [F7]            Tag file or directory for DELETE (see also [Shift+F7])
  8320.    [^F7]           Tag all files for DELETE
  8321.    [Alt+F7]        Logical DELETE (Ignore) - current file
  8322.    [Alt+^F7]       Logical DELETE (Ignore) - all files
  8323.    [Shift+F7]      Tag file for DESTROY (overwrite file, then delete)
  8324.    [Shift+^F7]     Tag all files for DESTROY
  8325.  
  8326.    [F8]            Execute default point & shoot command
  8327.    [^F8]           Execute default point & shoot command on all files
  8328.    [Shift+F8]      Execute default point & shoot command
  8329.    [Shift+^F8]     Execute default point & shoot command on all files
  8330.  
  8331.    [F9]            DOS gateway
  8332.    [Alt+F9]        Execute COM, EXE or BAT file
  8333.    [Shift+F9]      Execute command defined in EDDY.USE on current file
  8334.    [Shift+^F9]     Execute command defined in EDDY.USE on all files
  8335.  
  8336.    [F10]           Depends on context:
  8337.                    - if "directory recall" set, QUIT to chosen directory
  8338.                    - if not set, QUIT to original DOS default directory
  8339.    [^F10]          Same as [F10]; if EGA/VGA, lines per screen unchanged
  8340.    [Alt+F10]       QUIT, set new DOS default = working directory
  8341.    [Shift+F10]     Set directory recall
  8342.    [Shift+^F10]    Recall directory
  8343.  
  8344. |  [F11]           View disk space requirements for different cluster sizes
  8345.  
  8346.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page  A-3
  8347.  
  8348.  
  8349.  
  8350.    II. Letters
  8351.  
  8352.    [Alt+a]         Depends on context:
  8353.                    - EDIT...set ATTRIBUTE filter
  8354.                    - PATCH...truncate file AFTER cursor
  8355.  
  8356.    [b]             Toggle BIT-stripping state (LOOK)
  8357.    [Alt+b]         Depends on context:
  8358.                    - EDIT...copy with bit-stripping
  8359.                    - LOOK...(at file) toggle bit-stripping default state
  8360.                             (at disk) display "bad spot" as marked in FAT
  8361.                    - PATCH...truncate file BEFORE cursor
  8362.  
  8363.    [^c]            Cancel repeating command
  8364.    [Alt+c]         Set Synchronization CONTROLs
  8365.  
  8366.    [d]             Move ruler DOWN (LOOK)
  8367.    [Alt+d]         Depends on context:
  8368.                    - EDIT...sort by file DATE/time
  8369.                    - LOOK...(at disk) display DIRECTORY entry
  8370.    [Alt+Shift+d]   Sort permanently by file DATE/time
  8371.  
  8372.    [e]             EGA/VGA lines-per-screen toggle (LOOK)
  8373.    [Alt+e]         Sort by file EXTENSION
  8374.    [Alt+Shift+e]   Sort permanently by file EXTENSION
  8375.  
  8376.    [f]             Repeat previous FIND (LOOK)
  8377.    [^f]            FIND string in all files
  8378.    [Alt+f]         FIND string in file (EDIT/LOOK/FIND)
  8379.  
  8380.    [Alt+g]         Assign GLOBAL match character (FIND)
  8381.  
  8382.    [Alt+h]         Sort by file time (HOUR/minute)
  8383.    [Alt+Shift+h]   Sort permanently by file time
  8384.  
  8385.    [Alt+i]         INVERT display sequence
  8386.    [Alt+Shift+i]   INVERT permanently
  8387.  
  8388.    [j]             Depends on context:
  8389.                    - LOOK (at file, text) JUMP to line #
  8390.                    - LOOK (at file, hex) JUMP to file offset
  8391.                    - LOOK (at disk) JUMP to disk sector
  8392.    [Alt+j]         JUMP to disk cluster (LOOK at disk)
  8393.  
  8394.    [Alt+k]         Depends on context:
  8395.                    - FIND...set "don't match" byte in search string
  8396.                    - EDIT...show name for next key pressed
  8397.  
  8398.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page  A-4
  8399.  
  8400.  
  8401.    [l]             Toggle LINE-wrapping state (LOOK)
  8402. |  [^l]            Toggle "persistent" list file open/close
  8403.    [Alt+l]         Depends on context:
  8404.                    - EDIT...build list file
  8405.                    - LOOK...toggle line-wrapping default state
  8406.  
  8407.    [m]             MARK area to be copied (LOOK)
  8408.    [Alt+m]         Depends on context:
  8409.                    - EDIT...change command used for primary mouse key
  8410.                    - LOOK...jump to marked area
  8411.    [Alt+Shift+m]   Adjust mouse sensitivity
  8412.  
  8413.    [n]             Depends on context:
  8414.                    - cursor in filename/ext field: use as part of name
  8415.                    - cursor in attributes field: set file attribute OFF...
  8416.                      ...and move right (if on Archive, no move)
  8417.    [^n]            Turn attribute (column under cursor) ON for all files
  8418.    [Alt+n]         Depends on context:
  8419.                    - EDIT...sort by file NAME
  8420.                    - LOOK (at disk)...jump to NEXT cluster in chain
  8421.    [Alt+Shift+n]   Sort permanently by file NAME
  8422.  
  8423.    [Alt+o]         Depends on context:
  8424.                    - EDIT...OPTION settings
  8425.                    - LOOK (at disk)...find "owner" of sector/cluster
  8426.  
  8427.    [p]             Make hex display PRINTABLE (LOOK)
  8428.    [^p]            same as [Alt+p], except printer output goes to file
  8429.    [Alt+p]         Depends on context:
  8430.                    - EDIT...PRINT directory
  8431.                    - LOOK...PRINT file contents
  8432.                    - UPDATE...PRINT changes as they are made
  8433.  
  8434.    [Alt+q]         Set timestamp filter
  8435.  
  8436.    [r]             RULER line display (LOOK)
  8437.    [Alt+r]         Depends on context:
  8438.                    - LOOK...toggle REPLACE state
  8439.                    - EDIT (when customizing)...RAINBOW (color) selection
  8440.  
  8441.    [s]             Toggle LOOK Mode action for [up]/[down] between...
  8442.                    ...normal scrolling (1 line per keypress) and...
  8443.                    ...speed scrolling (half screen per keypress)
  8444.    [Alt+s]         Depends on context:
  8445.                    - EDIT...sort by file SIZE
  8446.                    - LOOK (at disk)...jump to STARTING cluster
  8447.    [Alt+Shift+s]   Sort permanently by file SIZE
  8448.  
  8449.    [Alt+t]         Depends on context:
  8450.                    - EDIT...TARGET directory inquiry/change using tree or box
  8451.                    - LOOK (at disk)...display TARGET directory cluster
  8452.    [Alt+Shift+t]   TARGET directory inquiry/change using dialog box
  8453.  
  8454.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page  A-5
  8455.  
  8456.  
  8457.  
  8458.    [u]             Move ruler UP (LOOK)
  8459.    [Alt+u]         Depends on context:
  8460.                    - EDIT...leave display UNSORTED...
  8461.                    - LOOK (at disk)...display next UNALLOCATED cluster
  8462.  
  8463.    [^v]            VOLUME serial number display/update
  8464.    [Alt+v]         VOLUME label add or change
  8465.    [Alt+Shift+v]   VOLUME label delete
  8466.  
  8467.    [w]             Toggle display between byte/word format (LOOK)
  8468.    [W]             Toggle display between word and...
  8469.                    ...inverted word format (LOOK)
  8470.    [^w]            "Where's That File?"
  8471.    [Alt+w]         Depends on context:
  8472.                    - EDIT...WORKING directory change using tree or box
  8473.                    - LOOK (at disk)...display WORKING directory cluster
  8474.    [Alt+Shift+w]   WORKING directory change using dialog box
  8475.  
  8476.    [Alt+x]         eXCHANGE working and target directories
  8477.  
  8478.    [y]             Depends on context:
  8479.                    - cursor in filename/ext field: use as part of name
  8480.                    - cursor in attributes field: set file attribute ON...
  8481.                      ...and move right (if on Archive, no move)
  8482.    [^y]            Turn attribute (column under cursor) ON for all files
  8483.    [Alt+y]         Delete bytes from beginning or end of file (PATCH)
  8484.  
  8485.    [Alt+z]         Depends on context:
  8486.                    - EDIT/UPDATE...view registration info
  8487.                    - PATCH...append ^Z to file
  8488.  
  8489.    [^letter]       From tree display or directory dialog box:
  8490.                    ...select drive indicated
  8491.  
  8492.  
  8493.  
  8494.    III.  Numbers
  8495.  
  8496.    [0]             After [#] or [Alt+#]...TABs are deleted during copy
  8497.  
  8498.    [1] - [8]       After [#] or [Alt+#]...
  8499.                        TABs expand to next "n"-byte boundary during copy
  8500.  
  8501.    [Alt+0]         Send formfeed to printer
  8502.  
  8503.    [Alt+1]         Send linefeed to printer
  8504.  
  8505.    [Alt+3]         Same as [Alt+#], described below
  8506.  
  8507.    [Alt+9]         Send command from EDDY.USE to printer
  8508.  
  8509.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page  A-6
  8510.  
  8511.  
  8512.  
  8513.    IV. Miscellaneous Keys
  8514.  
  8515. |  [Esc]           Depends on context:
  8516. |                  - EDIT...two [Esc]s in a row same as F10 (i.e., quit)
  8517. |                  - LOOK...return to EDIT
  8518. |                  - PATCH...return to LOOK
  8519. |                  - in response to "(y/n)?" message...same as [n]
  8520. |                  - general...exit from current process
  8521. |  [Shift+Esc]     - indicate that following keypress, if [F1] or [F2]...
  8522. |                    ...is to be treated as [F11] or [F12], respectively
  8523.  
  8524.    [Tab]           Depends on context:
  8525.                    - EDIT...toggle attributes display style
  8526.                    - LOOK...toggle display between hex/text
  8527.                    - PATCH/FIND...toggle data entry mode between hex/text
  8528. |  [Shift+Tab]     - LOOK/PATCH/FIND...set new key for hex/text toggle
  8529.  
  8530.    [Ins]           Enable file renaming for current file only
  8531.  
  8532.    [*]             Toggle file exclusion state
  8533.  
  8534.    [\]             Select drive from list of valid drives (EDIT/TREE)
  8535.  
  8536.    [.]             Depends on context:
  8537.                    - cursor on filename: move cursor to extension
  8538.                    - cursor NOT on filename: move cursor to start of filename
  8539.                    - working directory dialog box:
  8540.                      ...set file specification to "*.*"
  8541.  
  8542.    [:]             Move cursor to "hour" field
  8543.  
  8544.    [+]             Depends on context:
  8545.                    - cursor in attributes field: set file attribute ON...
  8546.                      ...and move down 1 line
  8547.                    - cursor in other field: move to attributes field
  8548.  
  8549.    [=]             Depends on context:
  8550.                    - if [Alt+=] previously used:
  8551.                      ...set file date/time to frozen timestamp
  8552.                    - if no [Alt+=]: set date/time to current DOS date/time
  8553.    [Alt+=]         Freeze timestamp at date/time of current file
  8554.  
  8555.    [-]             Depends on context:
  8556.                    - cursor in filename/ext field: use as part of name
  8557.                    - cursor in attributes field: set file attribute OFF...
  8558.                      ...and move down 1 line
  8559.                    - cursor in other field: move to attributes field
  8560.    [Alt+-]         Unfreeze timestamp frozen by preceding [Alt+=]
  8561.  
  8562.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page  A-7
  8563.  
  8564.  
  8565.    [/]             Depends on context:
  8566.                    - EDIT...Move cursor to "month" field
  8567.                    - FIND...Find next occurrence of search argument
  8568.  
  8569.    [#]             Choose tab expansion interval for current file (LOOK)
  8570.    [Alt+#]         Depends on context:
  8571.                    - EDIT...tag for copy, with tab expansion (or deletion)
  8572.                    - LOOK...choose tab expansion interval for all files
  8573.  
  8574. |  [!]             After [F9] (exit to DOS Shell), EDDY will try to swap its
  8575. |                  memory out to make more room for DOS, even when EDDY is
  8576. |                  configured for "no swapping".
  8577.  
  8578.    [right bracket] i.e., "]" -- TAB right (EDIT/LOOK)
  8579.    [left bracket]  i.e., "[" -- TAB left (EDIT/LOOK)
  8580.  
  8581.    [BackSpace]     Interrupt repeating command
  8582.  
  8583.    [ScrollLock]    Interrupt processing temporarily. Resume when...
  8584.                    ...[ScrollLock] is released.
  8585.  
  8586.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page  B-1
  8587.  
  8588.  
  8589.  
  8590.                                     Appendix B
  8591.  
  8592.  
  8593.                            What Does That Message Mean?
  8594.  
  8595.    The purpose of this Appendix is to explain some of EDDY's error and status
  8596.    messages which may not be completely self-explanatory or clear from their
  8597.    context.  Messages are listed alphabetically.
  8598.  
  8599.    When these messages are displayed on the screen, they are followed by a
  8600.    reminder that more information about why the message appeared and what, if
  8601.    anything, you should do about it, may be found in this Appendix.
  8602.  
  8603.    If you find some other messages EDDY produces that need clarification,
  8604.    please let me know, and I'll include them in the next update.
  8605.                            -----------------------------
  8606.  
  8607.    Can't adjust sensitivity
  8608.         An error has been returned by the mouse driver.  Probable cause is a
  8609.         non-Microsoft compatible mouse being used.
  8610.  
  8611.    Can't find Command Interpreter
  8612.         After searching the DOS environment, EDDY has either failed to locate
  8613.         the "COMSPEC" variable, which specifies where to find the command
  8614.         interpreter (usually COMMAND.COM), or has looked for the interpreter
  8615.         where COMSPEC said it was, but didn't find it there.
  8616.  
  8617.         You won't be able to do any DOS Gateway or Point & Shoot operations,
  8618.         but other EDDY commands will work correctly.  When you quit EDDY,
  8619.         though, you'll have a problem when DOS can't find COMMAND.COM either.
  8620.  
  8621.    Can't patch this file
  8622.         You have pressed [F4], but EDDY cannot get "write" access to the file.
  8623.         This is not just a read-only file; in that case, EDDY would ask first,
  8624.         and then remove the read-only status so that patching could proceed.
  8625.  
  8626.         This may occur on a network, if the file is part of a non-DOS file
  8627.         system, such as UNIX, and you don't have permission for write access.
  8628.  
  8629.    Can't proceed. EDDY.AUX problem
  8630.         Much of EDDY's functionality is stored in the EDDY.AUX file, as a set
  8631.         of overlays.  If this file can't be located, can't be read, is found
  8632.         to be corrupt, or is a different version than EDDY.COM, there really
  8633.         isn't much useful that EDDY can do.  Once you see this message, EDDY
  8634.         will terminate as soon as a key is pressed.
  8635.  
  8636.    Can't restore from swapfile
  8637.         You have just returned to EDDY after using the DOS Gateway, and an
  8638.         error was encountered in trying to restore the data that was stored
  8639.         there to make more memory available for Gateway processes.  Without
  8640.         restoring this data (and the corresponding memory allocations), EDDY
  8641.         cannot proceed reliably.  Therefore, the program terminates.
  8642.  
  8643.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page  B-2
  8644.  
  8645.  
  8646.  
  8647. |  Compressed disk appears to be full. COPY/MOVE aborted
  8648. |       The target disk is a CVF, and it indicates space is available to do
  8649. |       the i/o operation requested.  However, when writing to the target, not
  8650. |       all bytes requested were able to be written.  The most likely reason
  8651. |       is that the disk compression software has based its estimate of space
  8652. |       available on an expectation of being able to achieve more compression
  8653. |       than actually possible for the data involved.
  8654. |
  8655. |       The operation was not completed, but whatever WAS able to be written
  8656. |       is still in the file in the target directory.  However, the directory
  8657. |       entry most likely indicates a file size that is incorrect.  To check
  8658. |       this situation, run CHKDSK against the target directory.  To correct
  8659. |       it, run CHKDSK /F.
  8660.  
  8661.    Directory is part of target path
  8662.         You can't move a directory to its own "child", nor to any directory
  8663.         subordinate to it.  E.g., you can't move C:\UTIL to C:\UTIL\MISC; you
  8664.         could, however, move C:\UTIL\MISC to C:\ if you wished.
  8665.  
  8666.    Directory recall set
  8667.         You have pressed [Shift+F10], selecting the current working directory
  8668.         for possible "recall".  If you later press [Shift+^F10], this
  8669.         directory will again become the working directory.  If you press [F10]
  8670.         or [^F10], you will quit EDDY with this directory as the DOS default.
  8671.  
  8672.    DOS version problem
  8673.         This message appears if you execute EDDY under a DOS version earlier
  8674.         than 2.0, or if you try to rename a subdirectory or sort/shuffle and
  8675.         rewrite a directory but are using a level of DOS earlier than 3.0.
  8676.  
  8677. |  Evaluation period expired!  [function] not enabled.
  8678. |       After you have used EDDY for a month or so, and you have run it more
  8679. |       than 100 times, EDDY gets a bit heavier with its "nagging" at you to
  8680. |       register.  Surely, if you use it THAT much, it must be worth the low
  8681. |       registration price to you?  After so much use, in addition to nagging,
  8682. |       certain functions are no longer enabled in an unregistered copy:
  8683. |         . patching - [F4]
  8684. |         . EDDY.USE - [Shift+F9], [Shift+^F9] and [Alt+9]
  8685. |         . list files - [Alt+l], [^l]
  8686. |         . customizing - EDDY /0
  8687.  
  8688.    File not found. [Ins] to rename.
  8689.         You probably pressed a key by mistake, causing EDDY to go into speed-
  8690.         search mode for a matching filename that wasn't there.  If what you
  8691.         really wanted to do was rename the file, either press [Ins] to turn on
  8692.         renaming for that file, or set Option /F ON for all files.
  8693.  
  8694. |  Keyboard interrupt WAS controlled by unknown process at [segment:offset]
  8695. |       This is just a warning, to help you to understand a situation that may
  8696.  
  8697.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page  B-3
  8698.  
  8699.  
  8700.  
  8701. |       cause unusual behavior after EDDY terminates.
  8702. |
  8703. |       When EDDY runs, it intercepts ("hooks") the DOS keyboard interrupt
  8704. |       vector, in order to detect and process a [^c] keypress properly.
  8705. |       After processing a keyboard interrupt, control is passed to whatever
  8706. |       process had control of the keyboard vector before EDDY hooked it.
  8707. |       When you use the DOS Gateway functions, EDDY gives up control of the
  8708. |       vector, and hooks it again when you return from the Gateway.  When
  8709. |       EDDY terminates, it restores this vector to the value it had before
  8710. |       EDDY took control of it the last time.  In other words, EDDY is a good
  8711. |       MS-DOS citizen, and won't interfere with the workings of other good
  8712. |       citizens who need access to the keyboard interrupts.
  8713. |
  8714. |       However, if some ill-behaved process -- perhaps a TSR, or even a virus
  8715. |       of some sort -- takes over the vector WHILE EDDY HAS CONTROL of it,
  8716. |       then at termination time, EDDY can't be sure how to restore the
  8717. |       vector, removing EDDY from the keyboard interrupt process chain, while
  8718. |       still leaving the unknown process in control of the vector.  If the
  8719. |       unknown process receives a keyboard interrupt, and tries to pass
  8720. |       control back to the previous process that had hooked it (i.e., EDDY,
  8721. |       which has terminated), your system will hang!  To avoid that, EDDY
  8722. |       always restores the vector to the value it had before EDDY took
  8723. |       control, cutting the unknown process out of the chain.
  8724.  
  8725.    Memory corrupted!
  8726.         When EDDY temporarily gives up control to DOS for Gateway or Point &
  8727.         Shoot functions, a checksum of EDDY's memory area is computed and
  8728.         recorded.  It is computed again when EDDY regains control.  If there's
  8729.         a difference, some process that has been executed outside of EDDY has
  8730.         written to memory that belongs to EDDY.  EDDY terminates immediately,
  8731.         without attempting to restore any paths, colors, fonts, etc.
  8732.  
  8733.    No target. Delete all (y/n)?
  8734.         You have set the Synchronization Controls to specify that the files
  8735.         in the target are to be compared with those in the working directory,
  8736.         and the result used to determine which files will be tagged for
  8737.         DELETE.  But there is currently no target directory.
  8738.  
  8739.    Not enough memory
  8740.         This may appear when trying to use the DOS Gateway or Point & Shoot
  8741.         functions, and there is not enough memory to load the requested
  8742.         program.  It may also occur if EDDY returns from executing one of
  8743.         these functions, and finds that there is not enough memory available
  8744.         to continue (and so EDDY terminates).
  8745.  
  8746.         You might also see this message when you try to rewrite a sorted
  8747.         directory to disk.  It means there isn't enough room in memory for all
  8748.         of the directory entries plus workspace for the sort process.
  8749.  
  8750.    Not enough room in root directory
  8751.         Unlike subdirectories, the root has a maximum no. of entries that can
  8752.  
  8753.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page  B-4
  8754.  
  8755.  
  8756.  
  8757.         be contained in it.  This no. is set by the FORMAT process.  If the
  8758.         disk has a label, that uses one entry.  If you copy/move files to the
  8759.         root, and files with those names are not already in the root (shown by
  8760.         "COPY+" or "MOVE+"), a new directory entry is needed for each one.  If
  8761.         there are not enough entries available, you'll get this message.
  8762.  
  8763.    Not supported for this disk
  8764.         There are several conditions that can produce this message:
  8765.         1. The disk is a remote drive, accessed on a network, and you are
  8766.            attempting some low-level operation, such as sector patching.
  8767.         2. EDDY has received conflicting data regarding the disk format.  The
  8768.            program always cross-checks this data by calling combinations of
  8769.            BIOS and DOS functions, so that all critical data is treated to a
  8770.            "second opinion".  If there is disagreement, no low-level access
  8771.            will be attempted by EDDY.
  8772.         3. The "disk" is actually a compressed volume (DoubleSpace, Stacker,
  8773. |          etc.), and the requested operation could corrupt the internal
  8774. |          control structures.
  8775. |       4. A disk-image copy cannot be made of a compressed volume.  To accom-
  8776. |          plish the same thing, just do a regular COPY of the underlying,
  8777. |          hidden CVF.
  8778.         5. The disk is larger than 32 MB, and the version of DOS being used
  8779.            can't handle it.
  8780.  
  8781.    Path name too long
  8782.         This one can really be puzzling (some users have reported it as a
  8783.         bug).  When you have a path with a long chain of subdirectories, EDDY
  8784.         may refuse to move to a directory, giving this message.  It means DOS
  8785.         can't get to the directory, even though it's there.  This can happen
  8786.         if you rename a directory with a longer name, and the resulting path
  8787.         is longer than 64 bytes.  It can be even more obscure if you are using
  8788.         a SUBST'ed disk, so that the path doesn't look too long; however, DOS
  8789.         uses the total effective length, after expanding the SUBST path.
  8790.  
  8791.    Press key for primary mouse button
  8792.         EDDY is waiting for you to select -- by pressing -- a key to define
  8793.         the command to be executed whenever you subsequently press the primary
  8794.         (normally, the left) mouse button.
  8795.  
  8796.    Same disk
  8797. |       You cannot copy an entire disk image to a file on that same disk.
  8798.  
  8799.    Size shown in directory incorrect
  8800.         Probable cross-linked file.  Refer to Section 28.4.2 of this document.
  8801.  
  8802.    Timestamp frozen / Timestamp unfrozen
  8803.         When the timestamp is frozen, it will remain set to the same value,
  8804.         and that value will be used whenever [=] is pressed.  When it's
  8805.         unfrozen (or has never been frozen), the current DOS date and time
  8806.         will be used when [=] is pressed.
  8807.  
  8808.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page  B-5
  8809.  
  8810.  
  8811.  
  8812.    Unable to complete directory move
  8813.         Refer to Section 12.4.2 of this document.
  8814.  
  8815.    Unable to complete directory rewrite
  8816.         Refer to Section 26.4 of this document
  8817.  
  8818.    Unsure if files open. Sorting not attempted
  8819.         Refer to Section 26.1 of this document
  8820.  
  8821.    WARNING!  Memory allocation changed
  8822.         When EDDY temporarily gives up control to DOS for Gateway or Point &
  8823.         Shoot functions, the amount of free memory is recorded.  If the same
  8824.         amount of memory is not available when EDDY regains control, you've
  8825.         most likely run some program which has TSR'd (terminated and stayed
  8826.         resident).  Even if your system doesn't "hang", this will probably
  8827.         cause trouble when you finally quit, as there will be "holes" (small,
  8828.         often unusable blocks of memory) that can only be eliminated by
  8829.         rebooting.  If you can remove the TSR program by using the DOS
  8830.         Gateway, you should do so to avoid problems later.
  8831.  
  8832.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page  C-1
  8833.  
  8834.  
  8835.  
  8836.                                    Appendix C
  8837.  
  8838.                          Mouse Problems (Technical Note)
  8839.  
  8840.  
  8841. |  I.  Reset Method
  8842. |
  8843. |  EDDY performs a "reset" on the mouse driver at start-up and after use of
  8844. |  the DOS Gateway functions, to ensure that the mouse is in a known state for
  8845. |  subsequent operations.  There are two types of reset available: the one
  8846. |  EDDY uses by default is all handled by software, and is relatively quick,
  8847. |  but may, in unusual circumstances, lead to erratic behavior; the other
  8848. |  reset uses hardware functions, ensures that all aspects are properly
  8849. |  initialized, but is MUCH slower -- well over a second, which produces a
  8850. |  very noticeable delay when EDDY begins execution.
  8851. |
  8852. |  I have never actually encountered problems with the "quick" reset method,
  8853. |  but the experts say it can happen.  In case you're having mouse problems, a
  8854. |  configuration parameter is provided to let you choose the reset method that
  8855. |  works best for you; this is described in Section 30.3.2c.
  8856. |
  8857. |  If you're using the hardware reset but still have problems, read on...
  8858. |
  8859. |
  8860. |  II.  Driver Versions
  8861.  
  8862.    Over the years, a number of users have reported major problems in trying to
  8863.    use their mice with EDDY.  The movement would be erratic, if not random,
  8864.    and in some cases the mouse would either refuse to move, or move very
  8865.    slowly and refuse to respond to changing the sensitivity with EDDY (using
  8866.    the [Alt+Shift+m] command).
  8867.  
  8868.    Most users, on the other hand, have no such problems.  Until recently, I
  8869.    have never been able to reproduce this behavior, and thus haven't been very
  8870.    effective in getting it fixed.
  8871.  
  8872.    At last I have encountered the problems myself, and have been able to do
  8873.    some investigation.
  8874.  
  8875. |  When running Windows 3.1, and executing EDDY (prior to version 8a) in a DOS
  8876. |  box or from an icon, the mouse misbehaved terribly!
  8877.  
  8878.    Running without Windows, everything works fine.
  8879.  
  8880.    To get a mouse to work at all in the Windows DOS box, it is necessary to
  8881.    include a command to load the mouse driver from either AUTOEXEC.BAT or
  8882.    CONFIG.SYS, before starting Windows.  This is independent of the mouse
  8883.    driver used by Windows.  It also has nothing to do with EDDY; any DOS
  8884.    program that uses a mouse has the same requirement for a DOS-based driver.
  8885.  
  8886.    EDDY v.8c User's Manual  Copyright(C) 1987-96 by John Scofield   page  C-2
  8887.  
  8888.  
  8889.  
  8890.    I used the Microsoft MOUSE.COM driver, version 9.01, that came with PC-DOS.
  8891.    (This driver is 93,086 bytes, dated 12/31/93).
  8892.  
  8893.    When I traced out the activity with my debugger, I found that the values
  8894.    returned from mouse (interrupt 33 hex) function call number 11 -- "Read
  8895.    Mouse Motion Counters" -- were VERY erratic; sometimes reporting correct
  8896.    movement, but more often not.
  8897.  
  8898.    After much experimentation, I began to suspect that I had a problem that
  8899.    wasn't entirely EDDY's, but was somehow related to the hardware/software
  8900.    platform I was running on.  So, I tried using the Logitech mouse driver,
  8901.    MOUSE.COM version 6.23, from another system (40,596 bytes, dated 03/10/93).
  8902.  
  8903.    Suddenly, everything worked OK!
  8904.  
  8905.    Apparently I'm one of the last people in the world to learn about this
  8906.    problem!  A couple of weeks after I found out the hard way, I came across
  8907.    the book "Windows 3.1 Power Tools", by Geoffrey and William LeBlond.  This
  8908.    book, published by Bantam Books in 1992, devotes some six pages (!) to a
  8909.    discussion of this and similar situations.
  8910.  
  8911.    I HOPE this explains most, if not all, of the problems reported to me.  Of
  8912.    course, there's really no way to know, unless you share your experiences
  8913.    with me.  There are probably other hardware/software combinations which
  8914.    produce similar problems with EDDY, and there are certainly lots of others
  8915.    which run without a hitch.
  8916.  
  8917.    I would especially appreciate any feedback from users experiencing trouble
  8918.    in other situations, and I would also like to hear from any users who find
  8919.    that a similar change of mouse drivers resolves their problems.
  8920.  
  8921.    EDDY Registration Form
  8922.  
  8923.     -----------------------------------------------------------------------
  8924.  
  8925.                                                           Date ____________
  8926.  
  8927.     John Scofield
  8928.     117 West Harrison Bldg.
  8929.     6th floor, Dept. S-678
  8930.     Chicago, IL 60605
  8931.  
  8932.  
  8933.     Dear John:
  8934.  
  8935.     Please register me as another happy user of EDDY.  Here's my $29.95.
  8936.  
  8937.     I have version _8c_ of EDDY, which I got from _______________________
  8938.  
  8939.     ____________________________________________________________________ .
  8940.  
  8941.  
  8942.     Yours truly,
  8943.  
  8944.  
  8945.     ____________________________ (name)
  8946.  
  8947.     ____________________________ (address)
  8948.  
  8949.     ____________________________
  8950.  
  8951.     ____________________________                      If you need a
  8952.                                                       receipt, please
  8953.     ____________________________ (phone no.)          check here: ___
  8954.  
  8955.     My email address is: _____________________________
  8956.  
  8957.     P.S.  I'd like to see updates to EDDY posted to _____________________
  8958.           BBS, if possible.  Its phone number is: (    )________________.
  8959.  
  8960.  
  8961.     P.P.S.  I have the following comments or suggestions for EDDY:
  8962.  
  8963.